설정 매뉴얼 (Settings Guide)
### 기능 설명
`Settings`는 사용자의 계정 정보, 지도 스타일, 비밀번호, API 토큰 등 다양한 설정을 관리할 수 있는 기능입니다.
왼쪽 메뉴바(LNB) 하단에서 접근할 수 있으며, 클릭 시 별도의 **설정 모달 창**이 열립니다.
### 진입 방법
1. 화면 왼쪽 사이드바(LNB) 하단으로 이동합니다.
2. 아래의 이미지와 같이 빨간색 박스로 강조된 **`Settings` 버튼**을 클릭합니다.
3. 클릭 즉시 하단의 4가지 설정 항목을 구성한 **모달 창**이 화면 중앙에 나타납니다.
•
**User**: 계정 정보, 언어, 시작 페이지 등 기본 설정
•
**Map**: 지도 스타일 최대 4개 선택 및 적용
•
**Change Password**: 비밀번호 변경 기능
•
**Token**: 사용자 토큰 발급 및 관리
•
--
## 1. 사용자 정보 (User 탭)
### 기능 설명
사용자의 계정 정보, 언어, 시간대, 시작 페이지 등을 확인하거나 변경할 수 있는 기본 설정 화면입니다.
### 설정 위치
`[Settings > User]`
### 항목별 설명
| 항목 | 설명 |
|------------------|------|
| **Workspace** | 계정이 소속된 Workspace 이름입니다.|
| **Email** | 계정 등록 시 사용된 이메일 주소입니다. |
| **Name** | 사용자 이름을 자유롭게 수정할 수 있습니다. |
| **Start page** | 로그인 시 처음 열리는 기본 화면을 선택할 수 있습니다. |
| **Language** | 인터페이스 언어를 선택합니다. (현재 English만 지원됩니다.) |
| **Time zone** | 사용자의 현지 시간대 기준으로 설정합니다. |
| **Marketing 동의** | 체크 시 이벤트, 뉴스, 업데이트 등 마케팅 메시지를 수신합니다. |
### 사용자 예시
사용자 예시•
**Start page**를 `"Cargo Insight"`로 설정하면, 로그인 시 바로 Cargo Insight 페이지가 열립니다.
•
**Time zone**은 대한민국 기준 `UTC+09:00`을 선택하세요.
•
**Delete site data** 클릭 시 캐시와 설정이 초기화됩니다. *(현재는 기능이 지원되지 않습니다.)*
•
--
## 2. 지도 스타일 (Map 탭)
### 기능 설명
화면에 표시될 지도 스타일을 **정확히 4개** 선택하여,
Map Styles tool에서 다양한 환경에 맞는 지도를 빠르게 전환할 수 있도록 설정합니다.
### 설정 위치
`[Settings > Map]`
### 사용 방법
1. **Google Maps** 또는 **기타 지도 스타일** 중 총 **4개를 정확히 선택**합니다.
> 4개 미만 또는 초과로 선택하면 **저장할 수 없습니다.**
4개 미만 또는 초과로 선택하면 **저장할 수 없습니다.**2. 선택된 스타일은 체크박스로 표시되며, 4개를 초과하면 기존 선택을 해제해야 합니다.
3. 선택한 지도 스타일 중 하나의 이미지를 클릭하면, 해당 스타일이 **현재 화면에 미리 적용**됩니다.
4. 모든 조건을 충족한 뒤 **Save** 버튼을 클릭합니다.
5. 저장 시 아래와 같은 팝업이 표시됩니다:
> _You must re-login to save changes. Do you want to save?_
**Proceed**를 클릭하면 로그아웃과 함께 저장되며, 다시 로그인하면 선택한 지도 스타일이 적용됩니다.
### 선택 가능한 지도 스타일
•
**Google Map**:
`Road`, `Hybrid`, `Relief`, `Topographic`
•
**Others**:
`Basic Light`, `Basic Dark`, `Terrain Light`, `Satellite`
### TIP
TIP•
**Satellite** 스타일은 해양 물류 사용자들이 **지형 정보를 명확히 파악**할 수 있어 자주 활용됩니다.
•
**Basic Dark**는 **눈부심을 줄이는 용도**로 밤 시간대 또는 어두운 작업 환경에서 자주 선택됩니다.
*(사용자의 업무 환경에 따라 다를 수 있습니다.)*
•
사용자가 체크박스로 선택한 4개의 지도 스타일은 화면의 우측 상단 Tool Box의 Map Styles에서 확인 가능합니다.
### 주의 사항
주의 사항•
지도 스타일은 **반드시 정확히 4개**를 선택해야 저장할 수 있습니다.
→ 선택 수가 부족할 경우, 하단에 **Please select all 4 map styles.**가 표시되고 Save 버튼이 비활성화됩니다.
•
설정 저장 후 변경 사항은 **재로그인 시 반영**됩니다.
현재 작업 중인 내용이 있다면 먼저 저장한 후 설정 변경을 진행하세요.
—-
## 3. 비밀번호 변경 (Change Password 탭)
### 기능 설명
보안 강화를 위해 기존 비밀번호를 새로운 비밀번호로 변경할 수 있습니다.
### 설정 위치
`[Settings > Change Password]`
### 비밀번호 변경 방법
1. 현재 비밀번호를 입력합니다.
2. 새 비밀번호를 입력합니다. (6~15자, 영어 또는 특수문자 필수)
3. 한 번 더 입력하여 새 비밀번호를 확인합니다.
4. 모든 조건 충족 시 **Save** 버튼이 활성화됩니다.
### 사용자 예시
사용자 예시•
유효한 비밀번호 예: Seavantage@123•
유효하지 않은 예: 123456, abcdef (조건 미달) **비밀번호 분실 시**: 로그인 화면의 `Forgot password?` 링크를 클릭하여 이메일 인증을 진행하세요.•
--
## 4. 사용자 토큰 (Token 탭)
### 기능 설명
외부 시스템(API) 연동 등을 위한 인증 토큰을 **발급하고 관리**할 수 있는 메뉴입니다.
토큰은 일정 시간 동안 유효하며, 사용자가 직접 발급/복사/모니터링 할 수 있습니다.
### 설정 위치
`[Settings > Token]`
### 사용 방법
1. 현재 발급된 토큰 목록은 **In use** 영역에서 확인할 수 있습니다.
2. **Issue Token** 버튼을 클릭하여 새 토큰을 발급합니다.
- 단, **동시에 최대 2개의 토큰**만 활성 상태로 유지할 수 있습니다.
- 이미 2개의 토큰이 존재할 경우, 새 토큰을 발급하려면 기존 토큰 중 하나가 **만료되거나 삭제**되어야 합니다.
3. 발급된 토큰은 **168시간(7일)** 동안 유효합니다.
이후 자동으로 만료되며, **Expired** 영역에 표시됩니다.
4. 각 토큰의 **복사 아이콘**을 클릭하면 토큰 ID가 클립보드에 복사됩니다.
### 표시 항목
| 항목 | 설명 |
|------------------|------|
| **ID** | 토큰 고유 식별자 (복사 버튼 제공) |
| **Issued date** | 토큰이 발급된 날짜 및 시간 |
| **Expired date** | 만료 일시 (168시간 경과 후 자동 만료) |
### 주의 사항
주의 사항•
토큰은 **자동 갱신되지 않으며**, 유효 기간 만료 시 반드시 새로 발급해야 합니다.
•
동시에 사용할 수 있는 **활성 토큰은 최대 2개**까지이며, 초과 발급 시 기존 토큰이 **자동 만료 처리**됩니다.
•
만료된 토큰은 **Expired** 영역에서 확인할 수 있습니다.
•
토큰은 외부 시스템과의 인증에 사용되므로, **유출되지 않도록 철저히 보안에 유의**해야 합니다.
•
--