Files
jongryangje/app/Docs/manual/05_workspace.md
taekyoungc 7e32f579e8 feat: 워크스페이스 편의 개선 + 매뉴얼에 화면구성·단축키 페이지 추가
워크스페이스(탭)
- 탭 전환 시 좌측 사이드바(대메뉴/소메뉴) 강조 자동 동기화
  - nav 스크립트에 window.govPortalNav.syncByUrl() 공개, renderSidebar(overrideHref) 확장
- 키보드 단축키(Alt 기반): Alt+1~9 탭 이동, Alt+W 닫기, Alt+[ / Alt+] 이전·다음
  - iframe 내부 포커스에서도 동작하도록 같은 출처 문서에 핸들러 부착
- 탭 가운데(휠) 클릭으로 닫기, 잘린 탭 제목 전체 툴팁

매뉴얼
- 신규 페이지 [화면 구성·워크스페이스·단축키] (05_workspace.md, 목차 2번째)
  - 화면 구성, 탭 사용법·유지 범위, 단축키 표, 이동/도움말 안내
- 개요 페이지에서 새 페이지로 안내

e2e: 워크스페이스(사이드바 동기화·가운데클릭) + 매뉴얼(새 페이지·단축키·검색) 케이스 추가

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-08 23:09:25 +09:00

4.4 KiB
Raw Blame History

화면 구성 · 워크스페이스 · 단축키

이 시스템은 여러 작업 화면을 탭으로 열어 두고 오가며 일할 수 있도록 만들어졌습니다(웹 브라우저의 탭과 비슷합니다). 이 페이지는 화면이 어떻게 구성되는지, 탭을 어떻게 쓰는지, 그리고 빠르게 쓰는 단축키를 설명합니다.

1. 전체 화면 구성

로그인하면 워크스페이스(탭 작업공간)가 기본으로 열립니다. 화면은 크게 네 부분입니다.

영역 위치 설명
상단 헤더 맨 위 로고, 대분류 메뉴, 오른쪽에 소속 지자체·접속자·관리자·로그아웃
왼쪽 사이드바 좌측 현재 선택한 대분류의 소메뉴 목록. 아래에는 매뉴얼·FAQ 링크
탭바 본문 위 지금 열어 둔 작업 화면들의 탭 목록
본문 가운데 현재 탭의 실제 작업 화면

대분류를 클릭하면 왼쪽 사이드바에 그 안의 소메뉴가 펼쳐집니다. 현재 위치한 메뉴는 왼쪽에서 로 표시됩니다.

2. 탭(워크스페이스) 사용법

  • 메뉴를 클릭하면 탭으로 열립니다. 같은 메뉴를 다시 누르면 새 탭을 또 만들지 않고 이미 열린 탭으로 이동합니다.
  • 탭을 전환해도 작업 내용이 유지됩니다. A 화면에 무언가 입력하다가 B 화면을 잠깐 보고 와도, A 탭의 입력은 그대로 남아 있습니다.
  • 탭 ↔ 왼쪽 메뉴 연동: 탭을 전환하면 왼쪽 사이드바의 강조 위치도 그 탭의 메뉴로 자동으로 따라갑니다.
  • 탭이 많아지면 가로로 스크롤되며, 최대 12개까지 열 수 있습니다. 12개를 넘기면 가장 오래된 탭이 자동으로 닫힙니다.

탭의 버튼

버튼 동작
(탭 위) 탭만 새로고침합니다. 다른 탭은 그대로 둡니다.
× (탭 위) 그 탭을 닫습니다.
탭을 가운데(휠) 클릭 마우스 휠을 누르면 그 탭이 닫힙니다(브라우저와 동일).
탭에 마우스를 올리면 이름이 길어 잘렸을 때 전체 제목이 말풍선으로 보입니다.

탭이 유지되는 범위

  • 브라우저를 새로고침하거나 관리자 페이지에 갔다가 돌아와도 열어 두었던 탭이 다시 복원됩니다.
  • 단, 브라우저 탭(창)을 완전히 닫으면 작업공간은 초기화됩니다. (이 유지는 "이번 접속 동안"만 적용됩니다.)
  • 복원되는 것은 열려 있던 화면 목록입니다. 관리자 페이지를 거치는 등 작업공간을 완전히 벗어났던 경우, 각 화면은 새로 불러와지므로 입력 중이던 폼 내용까지 그대로 살아나지는 않습니다.

3. 키보드 단축키

자주 쓰는 동작은 키보드로 더 빠르게 할 수 있습니다. 브라우저 기본 단축키와 겹치지 않도록 Alt 키를 함께 누르는 방식입니다.

단축키 동작
Alt + 1 ~ 9 왼쪽에서 n번째 탭으로 이동
Alt + W 현재 탭 닫기
Alt + ] 다음 탭으로 이동
Alt + [ 이전 탭으로 이동

macOS 에서도 동일하게 Option(⌥) 키가 Alt 역할을 합니다 (예: ⌥ + 1).

참고: Ctrl/⌘ + W, Ctrl/⌘ + 숫자, Ctrl + Tab브라우저 자체가 먼저 가로채기 때문에 이 시스템에서 다른 용도로 바꿀 수 없어, 위와 같이 Alt 조합을 사용합니다.

4. 그 밖의 이동

  • 관리자 버튼(헤더 오른쪽, 관리자 권한일 때) — 메뉴·코드·판매소 등 관리자 설정 화면으로 이동합니다. 갔다가 워크스페이스로 돌아오면 열어 두었던 탭이 복원됩니다.
  • 지자체 선택(왼쪽 사이드바 아래) — 슈퍼 관리자가 작업할 지자체를 바꿀 때 사용합니다.
  • 로그아웃(헤더 오른쪽) — 시스템에서 나갑니다.

5. 도움말 보는 법

  • 각 작업 화면의 "이 화면 설명"() 버튼 — 지금 보고 있는 화면에 해당하는 매뉴얼이 새 탭으로 열립니다.
  • 이 매뉴얼 왼쪽 위 검색창 — 모든 매뉴얼 페이지에서 단어를 찾아, 결과를 누르면 해당 페이지의 그 단어 위치로 이동해 노란색으로 표시해 줍니다.