Initial commit

doc/공통기능/글로벌지원/Timezone.adoc

@@ -0,0 +1,34 @@
+= Timezone
+
+== 개요
+사용자의 Timezone을 관리한다.
+
+== Table
+* 사용자 : TN_CF_USER
+** TIME_ZONE_CODE, TIME_ZONE_ID 컬럼 사용
+
+== Timezone 저장
+
+* 사용자가 시스템에 최초 등록시 저장. +
+그 이후에는 '타임존 저장' API를 사용하여 저장한다.
+- 사용자가 시스템에 처음으로 SSO 로그인하여 사용자 등록시 epTray 연계된 타임존 정보를 가져와서 저장 (없을 경우 config.properties의 default 값)
+
+== API
+.UserController.java
+
+. 타임존 목록 조회 +
+GET /auth/users/timezone
+* 타임존은 java.util.TimeZone 라이브러리를 사용하기 때문에 DB에 타임존 목록이 저장되어 있지 않으며, +
+서머타임(일광 절약 시간제, DST(Daylight Saving Time))을 따로 계산하지 않아도 자동으로 목록에서 보여준다.
+
+. 타임존 저장 +
+PUT /auth/users/timezone
+
+== 화면
+사용자의 Timezone을 설정하는 기능으로, Timezone을 설정하게 되면 Local Storage의 *user.timeZoneId, user.timeZoneCode* 에 저장된다. +
+
+TopMenu - 표준시간을 통해 접근 가능.
+
+image::timezone.png[]
+
+NOTE: SideMenu(Right Side) 이용 시 MainOffsider.vue 내 'timezone' 부분에 구현되어 있다.

doc/공통기능/글로벌지원/다국어서비스.adoc

@@ -0,0 +1,56 @@
+= 다국어 서비스
+
+== 개요
+message-common.properties를 사용하여 시스템에 다국어를 지원한다. +
+한글, 영문을 기본으로 서비스한다. +
+기본언어인 한글은 message-common_ko_KR.properties을 파일명으로 하고 영문은 '_en_US'를 붙여서 사용한다.
+
+== 설정
+=== 프론트엔드 기본언어 값 설정
+..env
+[source,properties]
+----
+# To set default Language for I18n (ko_KR, en_US, zh_CN, etc..)
+VITE_DEFAULT_LANG=ko_KR
+----
+
+=== 백엔드 기본언어 및 다국어 설정
+.config.properties
+[source,properties]
+----
+## Language Set
+default-language=ko_KR
+language-set=ko_KR,en_US
+----
+
+* 예) 시스템에서 프랑스어를 추가하고자 할 때 방법
+. config.properties의 language-set에 fr_FR을 추가
++
+[source,properties]
+----
+## Language Set(프랑스어 추가)
+language-set=ko_KR,en_US,fr_FR
+----
+
+. message-common_fr_FR.properties 파일을 생성
+. 메세지의 프랑스어 버전 작성
+
+NOTE: 메세지들만 추가되므로 메뉴관리, 역할관리, 업무그룹관리 등 다국어 컬럼(LABEL_JSON)을 지원하는 table 데이터의 경우 직접 입력하여야 한다.
+
+== API
+.MessageBundleController.java
+
+. 로케일별로 메세지를 조회 +
+GET /noauth/messages
+
+. 설정한 모든 언어의 메세지를 조회 +
+GET /noauth/messages/all
+
+== 화면
+한국어,영어 중 원하는 언어로 변경하여 화면을 나타내는 기능으로, 언어를 설정하게 되면 User Token에 저장 되어 로그아웃을 하게 되더라도 마지막에 변경된 언어로 설정된다.
+
+TopMenu - 언어선택을 통해 접근 가능.(단, 다국어 지원 되는 영역에 한해서만 지원).
+
+image::language.png[]
+
+NOTE: SideMenu(Right Side) 이용 시 MainOffsider.vue 내 'language' 부분에 구현되어 있다.

doc/공통기능/글로벌지원/번역(Utrans).adoc

@@ -0,0 +1,20 @@
+= 번역(Utrans)
+
+== 개요
+Utrans API를 호출하여 한국어 및 영어 등 언어로 번역하는 기능.
+
+image::utrans.png[]
+
+=== 지원 되는 언어방향
+- 유럽어 : 러시아어,스페인어,독일어,프랑스어,이탈리아어,포르투갈어
+|===
+|Source |Target
+|한국어 | 영어, 중국어, 베트남어, 일어, 유럽어
+|영어 | 유럽어
+|중국어 | 유럽어
+|유럽어 | 유럽어
+|===
+
+=== 기능별 설명
+- 번역하기 : 번역된 내용을 오른쪽 창에 표시
+- 복사하기 : 번역 결과 값을 클립보드에 복사