@things-factory/operato-board 6.2.15 → 6.2.16

package/helps/faq/i18n-configuration.md

@@ -0,0 +1,53 @@
+## 다국어 기능 설정
+
+다음은 다국어 기능과 관련된 시스템 컨피규레이션 설정 사례이다.
+
+```
+  i18n: {
+    languages: [
+      {
+        code: 'en-US',
+        display: 'English'
+      },
+      {
+        code: 'ko-KR',
+        display: '한국어'
+      },
+      {
+        code: 'zh-CN',
+        display: '中文'
+      },
+      {
+        code: 'ja-JP',
+        display: 'にほんご'
+      },
+      {
+        code: 'ms-MY',
+        display: 'Bahasa Malaysia'
+      }
+    ],
+    defaultLanguage: 'en-US',
+    disableUserFavoredLanguage: false
+  },
+
+```
+
+### 다국어 언어 리스트 설정
+
+- `languages`:
+
+  - `languages`은 사용자가 선호 언어로 선택할 수 있는 언어의 종류이다.
+
+### 기본 언어 설정
+
+- `defaultLanguage`:
+  - 사용자에게 제공되는 기본 언어 설정이다.
+
+### 다국어 기능을 제약하는 설정
+
+- `disableUserFavoredLanguage`
+
+  - 이 값을 false로 설정하면
+    - 로그인 과정에서 다국어 선택 기능 제공
+    - 사용자 프로파일 메뉴에서 선호 언어 설정 기능 제공
+  - 이 값을 true로 설정하면, 사용자는 `defaultLanguage` 로 설정된 언어만을 사용하게 된다.

package/helps/faq/user-registration-process.md

@@ -0,0 +1,74 @@
+## 사용자 등록 프로세스
+
+사용자 등록 프로세스는 기본적으로 두가지 방식을 지원한다.
+
+- 사용자가 직접 등록 신청을 하고 이메일을 통한 확인 프로세스를 통해서 활성화하는 방식
+- 관리자가 직접 기본 패스워드로 사용자를 등록하고, 최초 로그인시에 사용자가 패스워드를 변경하는 방식
+
+## 시스템 컨피규레이션
+
+다음은 사용자 등록 프로세스와 관련된 시스템 컨피규레이션 설정 사례이다.
+
+```
+  password: {
+    lowerCase: true, /* 최소한 하나 이상의 영문 소문자가 포함되어야 한다. */
+    upperCase: false, /* 최소한 하나 이상의 영문 대문자가 포함되어야 한다. */
+    digit: true, /* 최소한 하나 이상의 숫자가 포함되어야 한다. */
+    specialCharacter: true, /* 최소한 하나 이상의 특수문자가 포함되어야 한다. */
+    allowRepeat: true, /* 동일 문자 반복을 허용한다. */
+    useTightPattern: true, /* 엄격한 패턴으로 강제한다. */
+    useLoosePattern: false, /* 느슨한 패턴을 허락한다. */
+    tightCharacterLength: 8, /* 엄격한 패턴시 패스워드의 최소 길이 */
+    looseCharacterLength: 15, /* 느슨한 패턴시 패스워드의 최소 길이 */
+    history: 2, /* 중복 사용을 허락하지 않는 과거 사용한 패스워드 갯수 */
+    defaultPassword: '7Hbat@1kG' /* 디폴트 패스워드 */
+  },
+  /*
+    Only When 'disableUserSignupProcess' is set to false,
+    a user-initiated user registration process is provided.
+    When this value is true, the 'defaultPassword' for the password must be configured.
+  */
+  disableUserSignupProcess: false, /* 사용자가 직접 등록하는 프로세스를 지원할 지 여부 */
+
+```
+
+### 패스워드 패턴 설정
+
+- `useTightPattern`:
+
+  - `useTightPattern`은 불리언(boolean) 값으로, 기본값은 `true`입니다.
+  - 만약 `useTightPattern`이 `true`로 설정되면, 비밀번호 패턴이 "타이트"하게 적용됩니다. 즉, 패스워드가 더 엄격한 규칙을 따라야 합니다.
+  - 타이트 패턴은 다음 규칙을 적용합니다:
+    - 적어도 하나의 소문자 알파벳을 포함해야 합니다.
+    - 적어도 하나의 대문자 알파벳을 포함해야 합니다.
+    - 적어도 하나의 숫자를 포함해야 합니다.
+    - 적어도 하나의 특수 문자 (예: !@#$%^&\*())를 포함해야 합니다.
+    - 문자 반복을 허용하지 않으며, 동일한 문자가 연속해서 3번 이상 나오지 않아야 합니다.
+    - 패스워드 길이는 `tightCharacterLength` 값보다 길어야 합니다. 기본값은 8입니다.
+
+- `useLoosePattern`:
+  - `useLoosePattern` 또한 불리언(boolean) 값으로, 기본값은 `false`입니다.
+  - 만약 `useLoosePattern`이 `true`로 설정되면, 비밀번호 패턴이 "루스"하게 적용됩니다. 이는 더 관대한 비밀번호 규칙을 의미합니다.
+  - 루스 패턴은 다음 규칙을 적용합니다:
+    - 패스워드 길이는 `looseCharacterLength` 값보다 길어야 합니다. 기본값은 15입니다.
+
+따라서 `useTightPattern`이 활성화되면 더 엄격한 비밀번호 규칙이 적용되고, `useLoosePattern`이 활성화되면 보다 관대한 비밀번호 규칙이 적용됩니다. 이 두 옵션을 통해 사용자가 원하는 비밀번호 규칙을 설정할 수 있습니다.
+
+### 사용자가 직접 등록 신청을 하기 위한 설정
+
+- `disableUserSignupProcess`
+
+  - 이 값을 false로 설정하면
+    - 로그인 과정에서 사용자 등록 링크를 제공
+    - 사용자 이메일을 통한 사용자 확인 및 활성화 프로세스 진행
+    - 사용자가 패스워드를 기억하지 못할 경우, 사용자 이메일을 통한 재설정 프로세스 제공
+  - 이 값을 true로 설정하면, 사용자가 직접 자신을 등록하는 프로세스 및 패스워드 재설정 프로세스는 사용할 수 없다.
+    - 이 경우에는 `password` 설정의 `defaultPassword` 가 필수적으로 제공되어야 한다.
+
+- `defaultPassword`
+
+  - password 설정의 `defaultPassword` 가 설정되면, 관리자는 `사용자 관리` 메뉴에서 신규 사용자를 생성할 수 있다.
+
+  - ![user-registration-process-by-manager]
+
+[user-registration-process-by-manager]: ./images/user-registration-process-01.png

package/helps/faq.md

@@ -118,6 +118,18 @@ A: [보드 운영 배포 관리](./faq/board-deployment.md)
 
 A: [서버 이중화 구성](./faq/server-redunduncy-configuration.md)
 
+### Q: 사용자 등록 프로세스를 사용하지 않는다면 ?
+
+사용자 등록 프로세스없이 관리자가 기본 패스워드로 사용자를 생성해주는 방식으로 운영하고 싶은데, 방법이 있나요 ?
+
+A: [사용자 등록 프로세스](./faq/user-registration-process.md)
+
+### Q: 다국어 기능을 사용하지 않는다면 ?
+
+다국어 기능을 사용하지 않고, 한가지 언어로만 사용할 수 있도록 강제할 수 있나요 ?
+
+A: [다국어 기능 설정](./faq/i18n-configuration.md)
+
 ---
 
 ## 추가 도움말 및 연락처 정보

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/operato-board",
-  "version": "6.2.15",
+  "version": "6.2.16",
   "main": "dist-server/index.js",
   "browser": "dist-client/index.js",
   "things-factory": true,
@@ -91,8 +91,8 @@
     "@things-factory/auth-azure-ad": "^6.2.15",
     "@things-factory/auth-google": "^6.2.15",
     "@things-factory/auth-ui": "^6.2.15",
-    "@things-factory/board-service": "^6.2.15",
-    "@things-factory/board-ui": "^6.2.15",
+    "@things-factory/board-service": "^6.2.16",
+    "@things-factory/board-ui": "^6.2.16",
     "@things-factory/context-ui": "^6.2.15",
     "@things-factory/export-ui": "^6.2.15",
     "@things-factory/fav-base": "^6.2.15",
@@ -121,8 +121,8 @@
     "@things-factory/system-ui": "^6.2.15"
   },
   "devDependencies": {
-    "@things-factory/board-test": "^6.2.15",
+    "@things-factory/board-test": "^6.2.16",
     "@things-factory/builder": "^6.2.2"
   },
-  "gitHead": "262fa72c069ac8745dd16acd695d0e87331fbc14"
+  "gitHead": "71862b915144bcec77878e63582771361d08c064"
 }

package/schema.graphql

@@ -413,13 +413,14 @@ type BoardTemplate {
   description: String
   domain: Domain
   id: ID!
+  mine: Boolean!
   model: String
   name: String
-  state: String
+  tags: Object
   thumbnail: String
   updatedAt: DateTimeISO
   updater: User
-  version: Float
+  visibility: String
 }
 
 type BoardTemplateList {
@@ -431,16 +432,10 @@ input BoardTemplatePatch {
   cuFlag: String
   description: String
   id: ID
-  model: String!
+  model: String
   name: String
-  state: BoardTemplateStatus
   thumbnail: String
-}
-
-"""state enumeration of a boardTemplate"""
-enum BoardTemplateStatus {
-  DRAFT
-  RELEASED
+  visibility: String
 }
 
 input ChatCompletionInput {
@@ -1943,7 +1938,22 @@ type Mutation {
   """To refresh oauth2 access token"""
   refreshOauth2AccessToken(id: String!): Oauth2Client!
 
-  """To release Board information"""
+  """To register a board as a board template with the given ID"""
+  registerBoardAsTemplate(
+    """description of board template to be regiestered"""
+    description: String!
+
+    """board Id to be regiestered"""
+    id: String!
+
+    """name of board template to be regiestered"""
+    name: String!
+
+    """visibility of board template to be regiestered"""
+    visibility: String!
+  ): BoardTemplate!
+
+  """To release a Board"""
   releaseBoard(id: String!): Board!
   renewApplicationAccessToken(id: String!, scope: String!): AccessToken!
 
@@ -2249,11 +2259,11 @@ input NewBoard {
 }
 
 input NewBoardTemplate {
-  description: String
+  description: String!
   model: String!
   name: String!
-  state: BoardTemplateStatus
   thumbnail: String
+  visibility: String!
 }
 
 input NewCommonCode {
@@ -3163,9 +3173,6 @@ type Query {
   """To fetch a BoardTemplate"""
   boardTemplate(id: String!): BoardTemplate
 
-  """To fetch a BoardTemplate by name"""
-  boardTemplateByName(name: String!): BoardTemplate
-
   """To fetch multiple BoardTemplates"""
   boardTemplates(filters: [Filter!], inherited: InheritedValueType, pagination: Pagination, sortings: [Sorting!]): BoardTemplateList!