Files
jongryangje/app/Docs/manual/05_workspace.md
taekyoungc 4d9343e980 feat: GBLS 리브랜딩 + 매뉴얼 보강 + 워크스페이스/코드관리 UX 개선
리브랜딩
- 서비스명 "종량제 시스템" → "GBLS", 헤더 로고에 풀네임(Garbage Bag Logistics System) 병기
  (gov-portal·공통 브랜드·로그인/welcome 셸·타이틀·푸터 전반)

매뉴얼
- 신규 페이지 [로그인·회원가입·계정](01_account.md): 가입 항목·관리자 승인·2차 인증 흐름
- [화면 구성·워크스페이스·단축키]에 계정 전환 시 탭 초기화 안내 추가

워크스페이스(탭)
- 탭 전환 시 좌측 사이드바 강조 동기화(메뉴 없는 화면은 강조 해제, 경로 폴백 매칭)
- 소메뉴 좌측 아이콘(▸/·) 전부 제거 — 활성 메뉴는 배경 강조로만 구분
- 탭을 사용자(mb_idx)별로 격리: 다른 아이디 로그인 시 이전 탭 복원 안 함
- 사이드바 FAQ 링크 제거(자주 묻는 질문은 매뉴얼에 통합)

기본 코드관리 화면
- 업무현황 카드 스타일로 재디자인(가벼운 표·상태/범위 pill·단일 구분선)
- render()에 $bare 옵션 추가 → 이미 카드형인 화면은 바깥 래퍼 생략

기타
- .claude/settings.local.json(개인 권한 설정) .gitignore 추가
- e2e: 워크스페이스(동기화·계정격리) + 매뉴얼(계정·단축키·검색) 케이스 보강

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-09 14:43:24 +09:00

4.5 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. 도움말 보는 법

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