칸반 보드 UI 시스템
목적
칸반 보드 UI 시스템은 워크플로우 상태 열, 카드 기반 작업 항목, 프로세스 파이프라인을 관리하기 위한 표준화되고 고밀도이며 접근 가능한 레이아웃 프레임워크를 제공합니다. 칸반 보드는 현대 SaaS 애플리케이션, 프로젝트 관리 도구, 지원자 추적 시스템(ATS), 영업 CRM 파이프라인의 핵심 상호작용 캔버스입니다.
효과적인 칸반 인터페이스를 설계하려면 높은 시각적 밀도, 독립적인 열 스크롤, 명확한 공간 계층, 실시간 WIP(Work-In-Progress) 제한 피드백, 그리고 다양한 뷰포트에 대한 유연한 대응 간의 균형을 맞춰야 합니다. 또한, 기존의 포인터 전용 드래그 앤 드롭 구현은 종종 심각한 접근성 장벽을 만듭니다. 이 스킬은 디자인과 기술적 실행을 연결하여, 열 컨테이닝, 작업 카드 구조, 터치 대상, 그리고 WCAG AA 표준을 준수하는 키보드/스크린 리더 재정렬 워크플로우에 대한 공간 규칙을 수립합니다.
사용 사례
- 프로젝트 및 작업 관리 시스템: 스프린트 보드, 백로그 열(예: 백로그, 진행 중, 코드 리뷰, 완료), 이슈 트래킹 보드 구조화.
- 지원자 추적 시스템(ATS): 지원자 채용 단계(예: 지원, 서류 심사, 면접, 오퍼, 채용 완료) 시각화.
- 영업 및 CRM 거래 파이프라인: 영업 리드 단계를 관리하고 열별로 집계된 거래 가치 및 단계 확률을 표시.
- 콘텐츠 편집 캘린더: 아이디어 구상부터 초안 작성, 검토, 게시까지의 기사 및 미디어 제작 워크플로우 추적.
- 주문 처리 작업 공간: 물류 또는 주방 디스플레이 인터페이스에서 다단계 주문 처리 모니터링.
사용하지 말아야 할 경우
- 데이터 그리드 및 표 형식 재무 목록: 정렬, 필터링, 대량 셀 편집이 필요한 다중 열 행 데이터의 경우
data-table-ui-system을 사용하세요. - 계층적 문서 또는 파일 트리: 깊이 중첩된 파일 구조 및 문서 개요의 경우
tree-view-navigation-system을 사용하세요. - 뷰포트 고정 SaaS 셸 레이아웃: 전체 애플리케이션 셸(탐색 모음, 상단 표시줄, 접이식 패널)의 경우
dashboard-layout-system을 사용하세요. - 단일 열 활동 피드: 시간 순서 스트림 피드 또는 간단한 세로 작업 목록의 경우
timeline-activity-system또는card-ui-system을 사용하세요.
입력
- 워크플로우 단계 및 열 분류: 정렬된 워크플로우 상태 목록(예: 할 일, 진행 중, 검토, 완료) 및 해당 열 메타데이터(WIP 제한, 상태 강조 색상, 거래 총액).
- 카드 데이터 밀도 매트릭스: 작업 카드당 표시할 속성(예: 작업 ID, 제목, 우선순위 태그, 마감일, 담당자 아바타, 하위 작업 진행률, 첨부 파일 개수).
- 뷰포트 및 셸 컨텍스트: 상위 애플리케이션 셸(
dashboard-layout-system)에서 제공하는 레이아웃 경계. - 디자인 토큰: 색상 팔레트, 입체감 표면, 간격 척도, 타이포그래피 토큰(
accessible-color-system,elevation-and-depth-system,fluid-spacing-system).
출력
- 수평 열 캔버스 사양: 뷰포트 고정 수평 스크롤 컨테이너, 고정 열 너비, 거터 간격에 대한 공간 레이아웃 정의.
- 열 헤더 및 WIP 제한 구조: 열 헤더, 배지 카운터, WIP 제한 경고 임계값(정상, 임박, 초과), 빠른 추가 작업 트리거에 대한 시각적 디자인.
- 작업 카드 구성 요소 사양: 표준, 간소형, 확장형 작업 카드에 대한 구조화된 레이아웃 청사진. 여기에는 드래그 핸들 대상, 메타데이터 그리드, 호버/포커스/그랩 상호작용 상태가 포함됩니다.
- 접근 가능한 키보드 및 드래그 앤 드롭 모델: ARIA 역할 매핑(
role="region",role="list",role="listitem"), 포커스 관리 경로, 키보드 재정렬 단축키,aria-live알림 패턴. - 반응형 모바일 피벗 전략: 소형 화면에서 다중 열 수평 레이아웃을 분할 탭 보기 또는 쌓인 아코디언 패널로 전환하는 레이아웃 적응 지침.
워크플로우
1. 수평 열 캔버스 구조 설정
메인 보드 작업 공간을 뷰포트 고정 셸(dashboard-layout-system) 내에 구성합니다.
- 컨테이너 크기 조정: 보드 래퍼를
display: flex; flex-direction: row; height: 100%; overflow-x: auto; overflow-y: hidden;으로 설정하여 보드 헤더는 고정하면서 열 간 가로 스크롤이 가능하게 합니다. - 열 치수: 고정 또는 플렉스-수축 열 너비 정의(
min-width: 280px; max-width: 340px; width: 300px;). 열이280px미만으로 축소되지 않도록 하여 텍스트 잘림 및 터치 대상 축소를 방지합니다. - 거터 및 패딩: 일관된 열 간격(예:
gap: var(--space-m, 16px)) 및 가로 패딩(예:padding: 16px 24px)을 설정합니다. - 열 컨테이너 셸: 각 열을 독립적인 플렉스 컨테이너로 스타일링합니다(
display: flex; flex-direction: column; max-height: 100%; background: var(--surface-neutral-subtle); border-radius: 8px; border: 1px solid var(--border-subtle);).
2. 열 헤더 및 WIP 신호 설계
각 열 헤더는 열 스택 상단에 고정된 제어 막대 역할을 합니다.
- 고정 열 헤더: 헤더를 열 플렉스 스택 상단에 배치합니다(
flex-shrink: 0; padding: 12px 16px; display: flex; align-items: center; justify-content: space-between;). - 헤더 요소:
- 상태 강조 표시기: 단계에 해당하는 10x10px 컬러 필 또는 왼쪽 테두리(예: 파랑 = 진행 중, 보라 = 검토, 녹색 = 완료).
- 열 제목: 잘린 텍스트(
font-weight: 600; font-size: 0.9375rem; color: var(--text-primary)). - 카드 카운터 및 WIP 제한 배지: 항목 개수를 WIP 제한과 함께 표시합니다(예: "3/5").
- 열 작업 메뉴: 열 설정, 정렬 또는 축소 옵션에 대한 액세스를 제공하는 32x32px 아이콘 버튼(
...).
- WIP 제한 시각적 상태:
- 정상(제한 미만): 미묘한 중립 배지 배경(
background: var(--surface-neutral-muted); color: var(--text-secondary)). - 경고(제한 도달): 호박색 배지 배경(
background: var(--surface-warning-subtle); color: var(--text-warning-bold)). - 초과(제한 초과): 빨간색 배지 또는 강조 표시된 헤더 테두리(
background: var(--surface-danger-subtle); border-color: var(--border-danger); color: var(--text-danger))와 함께 접근 가능한 경고 아이콘 및 워크플로우 병목 현상을 설명하는 툴팁.
- 정상(제한 미만): 미묘한 중립 배지 배경(
3. 독립적인 열 스크롤 영역 구축
단일 열에서 긴 카드 목록을 검사할 때 보드나 페이지 전체가 세로로 스크롤되는 것을 방지합니다.
- 카드 리스트 컨테이너: 리스트 컨테이너(
role="list")에flex: 1; overflow-y: auto; overflow-x: hidden; padding: 8px 12px 12px 12px; display: flex; flex-direction: column; gap: 8px;를 적용합니다. - 관성 및 부드러운 스크롤:
-webkit-overflow-scrolling: touch;를 활성화하고 사용자 정의 스크롤바(미묘한 6px 스크롤바)를 사용하여 개별 열이 전역 페이지 이동을 유발하지 않고 부드럽게 스크롤되도록 합니다. - 빈 상태 컨테이너: 열에 0개의 카드가 포함된 경우, 점선 드롭 영역 윤곽선(
border: 2px dashed var(--border-muted); border-radius: 6px; padding: 24px; text-align: center;)과 미묘한 레이블("이 단계에 작업이 없습니다") 및 빠른 "카드 추가" 버튼을 표시합니다.
4. 작업 카드 구성 요소 계층 구조 구축
visual-hierarchy-system을 사용하여 명확한 시각적 스캔 순서로 작업 카드를 설계합니다.
- 카드 기본 구조: 각 카드를 고유한 리스트 항목(
role="listitem"/article)으로 렌더링하고background: var(--surface-card); border: 1px solid var(--border-subtle); border-radius: 6px; padding: 12px; box-shadow: var(--shadow-sm); transition: transform 0.15s ease, box-shadow 0.15s ease; cursor: grab;를 적용합니다. - 카드 영역 분류:
- 상단 행(태그 및 작업): 우선순위 배지(예: 높음, 긴급, 고대비 필) 및 작업 참조 ID(예: "PROJ-1042"). 24x24px 드래그 핸들 버튼 포함(
aria-label="Reorder card PROJ-1042"). - 중간 영역(제목 및 설명): 주요 작업 제목(
font-weight: 600; font-size: 0.875rem; line-clamp: 2; margin-bottom: 8px;). 선택적 1줄 흐린 텍스트 요약. - 하단 메타 행(진행률 및 담당자): 왼쪽에는 마감일 표시기(기한 초과 시 빨간색 강조) 및 하위 작업 체크리스트 진행률(예: "3/5 ✓")을 표시합니다. 오른쪽에는 쌓인 담당자 아바타(
user-avatar-system)를 표시합니다.
- 상단 행(태그 및 작업): 우선순위 배지(예: 높음, 긴급, 고대비 필) 및 작업 참조 ID(예: "PROJ-1042"). 24x24px 드래그 핸들 버튼 포함(
- 카드 상호작용 상태:
- 호버: 약간의 그림자 증가(
box-shadow: var(--shadow-md); border-color: var(--border-hover)). - 포커스: 매우 가시적인 2px 오프셋 포커스 링(
outline: 2px solid var(--focus-ring); outline-offset: 2px). - 드래깅/그랩 상태:
opacity: 0.6; transform: scale(1.02) rotate(1deg); cursor: grabbing; box-shadow: var(--shadow-xl); z-index: 1000;. - 드롭 대상 신호: 카드를 열 드롭 영역 위로 가져갈 때 애니메이션 삽입 자리 표시자 간격(
height: 60px; border: 2px dashed var(--brand-primary); border-radius: 6px; background: var(--brand-subtle);)을 표시합니다.
- 호버: 약간의 그림자 증가(
5. 접근 가능한 키보드 및 스크린 리더 드래그 앤 드롭 구현
표준 드래그 앤 드롭 프레임워크(HTML5 Drag and Drop API)는 키보드 및 스크린 리더 사용자에게 자주 접근 불가능합니다. 명시적인 대체 키보드 탐색 모드를 구현합니다.
- 키보드 재정렬 트리거: 사용자가 드래그 핸들 또는 카드에 포커스를 맞추고
Space또는Enter를 눌러 "이동 모드"로 진입할 수 있습니다. - 선택 시 포커스 및 알림: 이동 모드가 활성화되면
aria-grabbed="true"(또는 이동 트리거의aria-pressed="true")를 설정하고, 카드 주위에 시각적인 "그랩됨" 후광을 표시하며, 보이지 않는aria-live="polite"영역을 통해 알림을 제공합니다: "카드 PROJ-1042를 잡았습니다. 현재 '진행 중' 열, 5개 중 2번째 위치에 있습니다. 이동하려면 방향키 또는 Alt+방향키를 사용하고, 놓으려면 Space, 취소하려면 Escape를 누르십시오." - 열 간 및 열 내 이동:
- 위/아래 방향키: 현재 열 목록 내에서 카드 순서를 변경합니다.
- 왼쪽/오른쪽 방향키: 카드를 인접한 왼쪽 또는 오른쪽 열로 이동하여 해당 열 목록 끝에 추가합니다.
- 놓기 및 취소 확인:
- Space / Enter: 배치를 확인합니다. DOM 위치를 업데이트하고, 그랩 상태를 해제하며, 놓인 카드에 포커스를 설정하고 알림을 제공합니다: "카드 PROJ-1042가 '검토' 열, 3개 중 1번째 위치에 놓였습니다."
- Escape: 이동을 취소합니다. 카드를 원래 위치로 되돌리고 알림을 제공합니다: "이동이 취소되었습니다. 카드가 '진행 중' 열, 2번째 위치로 돌아갔습니다."
6. 모바일 뷰포트 적응
소형 모바일 화면(<768px)에서 다중 열 수평 스크롤은 심각한 수평 스와이프 피로와 어색한 카드 드롭을 유발합니다. 반응형 변환 전략을 구현합니다.
- 분할 열 탭(권장 모바일 패턴): 768px 미만 화면에서는 수평 스크롤 캔버스를 숨깁니다. 보드 상단에 고정된 분할 탭 컨트롤(
segmented-control-system)을 렌더링하고, 항목 개수 배지가 있는 열 제목을 표시합니다(예:[ 할 일 (4) ] [ 진행 중 (3) ] [ 완료 (8) ]). - 단일 열 활성 보기: 활성 열 목록만 전체 너비(
width: 100%)로 표시합니다. - 상황별 "이동" 모달/액션 시트: 모바일에서 카드를 탭하면 카드 메뉴에 명시적인 "이동..." 버튼을 제공합니다. 탭하면 대상 열을 나열하는 하단 시트(
accessible-bottom-sheet-implementation)가 열려 모바일 화면에서 터치 드래그 제스처를 완전히 제거하고 한 번의 탭으로 재배치할 수 있습니다.
의사 결정 규칙
모바일 열 레이아웃 전략
| 뷰포트 너비 | 권장 UI 패턴 | 상호작용 메커니즘 |
|---|---|---|
| 데스크톱 (>1024px) | 다중 열 수평 그리드 캔버스 | 동시에 여러 열 표시, 포인터 드래그 앤 드롭 + 키보드 이동 모드. |
| 태블릿 (768px - 1023px) | 컴팩트 열 보드 (수평 스크롤) | 좁아진 열(260px), 부드러운 터치 수평 스와이프 스냅. |
| 모바일 (<768px) | 분할 열 탭 + 단일 활성 열 | 상단 상태 탭, 단일 열 전체 너비 카드, "이동" 하단 시트. |
열 너비 전략
- 고정 열 너비 (
300px): 3-6개의 열이 있는 표준 보드에 가장 적합합니다. 열은 예측 가능한 너비를 유지하고 추가 열은 수평 오버플로로 깔끔하게 넘어갑니다. - 유동 플렉스 열 (
flex: 1; min-width: 280px): 넓은 화면에서 정확히 3개의 열(예: 할 일, 진행 중, 완료)이 있는 보드에 가장 적합하며, 열이 사용되지 않는 오른쪽 공백 없이 전체 뷰포트 너비를 균일하게 채울 수 있습니다.
WIP 제한 초과 처리
- 소프트 WIP 제한(경고만): 열 헤더를 호박색/빨간색으로 강조 표시하고 초과 배지를 표시하지만, 사용자가 열로 카드를 이동하는 것을 허용합니다. 일시적인 병목 현상이 발생할 수 있는 창의적인 작업 및 민첩한 팀 워크플로우에 권장됩니다.
- 하드 WIP 제한(차단): 제한에 도달하면 열에 카드 드롭을 방지하고 모달 또는 인라인 알림을 표시합니다: "WIP 제한에 도달했습니다(5/5). 추가하기 전에 기존 작업을 해결하십시오." 해당 열로의 키보드 이동을 비활성화합니다. 엄격하게 규제되는 운영 워크플로우에 권장됩니다.
제약 조건
- 접근성(WCAG 2.1 AA):
- SC 2.1.1 키보드: 모든 카드 기능(편집, 재정렬, 삭제, 이동)은 키보드만으로 도달하고 작동할 수 있어야 합니다.
- SC 2.4.7 포커스 가시성: 포커스된 카드 및 드래그 핸들은 배경에 대해 최소 3:1 명암비를 가진 잘리지 않은 포커스 링을 갖추어야 합니다.
- SC 4.1.3 상태 메시지: 카드 이동 작업, WIP 경고, 필터 결과는
aria-live="polite"영역을 통해 알려져야 합니다. - SC 2.5.8 대상 크기: 드래그 핸들, 카드 메뉴 트리거(
...), 빠른 추가 버튼은 최소 24x24px의 터치 대상(터치 기기에서는 44x44px 권장)을 제공해야 합니다.
- 레이아웃 컨테이닝 및 CLS: 열 리스트 컨테이너는 동적 카드 업데이트 시 레이아웃 붕괴 또는 페이지 수준 점프를 방지하기 위해 고정 헤더와 함께
overflow-y: auto를 지정해야 합니다. - 성능: 카드 리스트를 효율적으로 렌더링합니다. 보드에 200개 이상의 카드가 포함된 경우, 드래그 작업 중 60fps 렌더링을 유지하기 위해 열별로 가상 리스트 스크롤(
virtual-list-implementation)을 구현합니다.
관련 스킬
dashboard-layout-system: 칸반 보드가 포함된 상위 애플리케이션 셸 레이아웃.accessible-color-system: WIP 제한 상태 및 접근성 대비를 위한 강조 및 시맨틱 색상.elevation-and-depth-system: 카드 그랩 그림자 및 드래그 오버레이에 대한 입체감 계층.fluid-spacing-system: 거터, 카드 내부 패딩, 드래그 핸들 대상에 대한 간격 및 여백 토큰.visual-hierarchy-system: 카드 내 제목, 메타데이터, 작업 간의 시각적 가중치 순서.user-avatar-system: 작업 카드 하단 메타 행의 쌓인 아바타.segmented-control-system: 작은 뷰포트를 위한 열 탭으로 변환.accessible-bottom-sheet-implementation: "이동" 모바일 액션 시트.virtual-list-implementation: 고성능 대규모 보드를 위한 열당 가상화.