@things-factory/integration-base 7.0.0-alpha.8 → 7.0.0

package/helps/integration/concept/script-internal-variables.ja.md

@@ -17,8 +17,28 @@
     - email: ユーザーの電子メール
     - userType: ユーザータイプ
 
-  - lng: シナリオを開始するユーザーのブラウザで使用されている言語（例：en-US、ko-KR など）。 ユーザーのブラウザを介さないリクエストを処理する場合、この組み込み変数は提供されない場合があります。
+  - lng: シナリオを開始するユーザーのブラウザで使用されている言語（例：en-US、ko-KR など）。
+
+    - ユーザーのブラウザを介さないリクエストを処理する場合、この組み込み変数は提供されない場合があります。
 
   - variables: シナリオ呼び出し時に呼び出し元から受け取るオブジェクト。
 
   - data: シナリオの実行中に生成された各ステップの結果データ。
+
+  - logger (only for script)：スクリプト内で必要に応じてログを残すことができる
+    - ログレベル：info, warn, error
+
+```javascript
+// 組み込み変数と変数の使用例
+const username = user ? user.name : '不明なユーザー'
+const companyName = domain ? domain.name : '不明な会社'
+
+// info レベルのログを残す例（組み込み変数と変数を使用）
+logger.info(`ユーザー '${username}' が '${companyName}' からシステムにアクセスしました。`)
+
+// warn レベルのログを残す例（組み込み変数と変数を使用）
+logger.warn(`ユーザー '${username}' が許可されていない操作を試みました。`)
+
+// error レベルのログを残す例（組み込み変数と変数を使用）
+logger.error(`ユーザー '${username}' のデータ処理中にエラーが発生しました。`)
+```

package/helps/integration/concept/script-internal-variables.ko.md

@@ -16,3 +16,20 @@
     - 사용자 브라우저를 통하지 않은 요청을 처리할 때에는 이 내장변수가 제공되지 않을 수 있다.
   - variables : 시나리오 호출 시점에 호출자로부터 전달받은 오브젝트
   - data: 시나리오 실행과정에 생성된 각 스텝의 결과 데이타
+  - logger: 스크립트 내에서 필요시 로그를 남길 수 있도록 제공된다
+    - log levels : info, warn, error
+
+```javascript
+// 내장 변수와 변수 사용 예시
+const username = user ? user.name : 'Unknown User'
+const companyName = domain ? domain.name : 'Unknown Company'
+
+// info 레벨의 로그를 남기는 예시 (내장 변수 및 변수 사용)
+logger.info(`User '${username}' from '${companyName}' accessed the system.`)
+
+// warn 레벨의 로그를 남기는 예시 (내장 변수 및 변수 사용)
+logger.warn(`User '${username}' attempted an unauthorized action.`)
+
+// error 레벨의 로그를 남기는 예시 (내장 변수 및 변수 사용)
+logger.error(`An error occurred while processing data for user '${username}'.`)
+```

package/helps/integration/concept/script-internal-variables.md

@@ -22,3 +22,21 @@ In script-type task properties (Script, SQL, GraphQL Query/Mutation, Log, etc.),
   - variables: An object received from the caller at the time of scenario invocation.
 
   - data: Results data generated for each step during scenario execution.
+
+  - logger (only for script): Provided to leave logs as needed within the script
+    - log levels: info, warn, error
+
+```javascript
+// Example of using built-in variables and variables
+const username = user ? user.name : 'Unknown User'
+const companyName = domain ? domain.name : 'Unknown Company'
+
+// Example of leaving a log at the info level (using built-in variables and variables)
+logger.info(`User '${username}' from '${companyName}' accessed the system.`)
+
+// Example of leaving a log at the warn level (using built-in variables and variables)
+logger.warn(`User '${username}' attempted an unauthorized action.`)
+
+// Example of leaving a log at the error level (using built-in variables and variables)
+logger.error(`An error occurred while processing data for user '${username}'.`)
+```

package/helps/integration/concept/script-internal-variables.ms.md

@@ -17,4 +17,22 @@ Dalam sifat tugas jenis skrip (Skrip, SQL, Pertanyaan/Mutasi GraphQL, Log, dsb.)
     - email: E-mel pengguna
     - userType: Jenis pengguna
 
-  - lng: Bahasa yang digunakan oleh pelayar pengguna ketika memulakan senario (contohnya, en-US, ko
+  - lng: Bahasa yang digunakan oleh pelayar pengguna ketika memulakan senario (contohnya, en-US, ko-KR)
+
+  - logger (only for script): menyediakan kemampuan untuk meninggalkan log apabila diperlukan dalam skrip
+    - tahap log: info, warn, error
+
+```javascript
+// contoh penggunaan variable bawaan dan variable
+const username = user ? user.name : 'Pengguna Tidak Diketahui'
+const companyName = domain ? domain.name : 'Syarikat Tidak Diketahui'
+
+// contoh meninggalkan log tahap info (menggunakan variable bawaan dan variable)
+logger.info(`Pengguna '${username}' dari '${companyName}' mengakses sistem.`)
+
+// contoh meninggalkan log tahap warn (menggunakan variable bawaan dan variable)
+logger.warn(`Pengguna '${username}' mencuba tindakan yang tidak dibenarkan.`)
+
+// contoh meninggalkan log tahap error (menggunakan variable bawaan dan variable)
+logger.error(`Terjadi kesalahan semasa memproses data untuk pengguna '${username}'.`)
+```

package/helps/integration/concept/script-internal-variables.zh.md

@@ -22,3 +22,21 @@
   - variables: 在方案调用时从调用者那里接收的对象
 
   - data: 在方案执行过程中生成的每个步骤的结果数据
+
+  - logger(only for script)：在脚本中需要时可以留下日志
+    - 日志级别：info, warn, error
+
+```javascript
+// 内置变量和变量使用示例
+const username = user ? user.name : '未知用户'
+const companyName = domain ? domain.name : '未知公司'
+
+// 记录 info 级别日志的示例（使用内置变量和变量）
+logger.info(`用户 '${username}' 从 '${companyName}' 访问了系统。`)
+
+// 记录 warn 级别日志的示例（使用内置变量和变量）
+logger.warn(`用户 '${username}' 尝试了未授权的操作。`)
+
+// 记录 error 级别日志的示例（使用内置变量和变量）
+logger.error(`处理用户 '${username}' 的数据时发生错误。`)
+```

package/helps/integration/connector/mssql-connector.ja.md

@@ -1,33 +1,33 @@
-# MSSqlコネクタ
+# MS-SQLコネクタ
 
-## MSSqlとは
+## MS-SQLとは
 
-[MSSql](https://www.microsoft.com/sql-server)はMicrosoft SQL Serverです。
+[MS-SQL](https://www.microsoft.com/sql-server)はMicrosoft SQL Serverです。
 
 ## 設定
 
 ### エンドポイント
 
-MSSqlエンジンのホスト名とサービスポート
+MS-SQLエンジンのホスト名とサービスポート
 
 - ホスト名：データベースサーバーホスト
-- サービスポート：データベースサービスポート（デフォルト - 5432）
+- サービスポート：データベースサービスポート（デフォルト - 1433）
 - フォーマット
   - {ホスト名}[:{ポート}]
   - 例
-    - "localhost:5432"
+    - "localhost:1433"
     - "localhost"
-    - "192.168.0.1:5432"
+    - "192.168.0.1:1433"
 
 ## パラメーター
 
 ### ユーザー
 
-- MSSqlデータベースのユーザーID
+- MS-SQLデータベースのユーザーID
 
 ### パスワード
 
-- MSSqlデータベースのユーザーパスワード
+- MS-SQLデータベースのユーザーパスワード
 
 ### データベース
 
@@ -36,3 +36,7 @@ MSSqlエンジンのホスト名とサービスポート
 ### 暗号化
 
 - 暗号化された接続
+
+### サーバー証明書の信頼性
+
+- MS-SQL サーバーにインストールされた SSL/TLS 証明書が自己署名証明書であっても信頼できるかどうか

package/helps/integration/connector/mssql-connector.ko.md

@@ -1,33 +1,33 @@
-# mssql 커넥터
+# MS-SQL 커넥터
 
-## mssql
+## MS-SQL
 
-[mssql](https://www.microsoft.com/sql-server)은 Microsoft SQL Server입니다.
+[MS-SQL](https://www.microsoft.com/sql-server)은 Microsoft SQL Server입니다.
 
 ## 설정
 
 ### 엔드포인트
 
-mssql 엔진 호스트 이름과 서비스 포트
+MS-SQL 엔진 호스트 이름과 서비스 포트
 
 - 호스트 이름 : 데이터베이스 서버 호스트
-- 서비스 포트 : 데이터베이스 서비스 포트 (기본값 - 5432)
+- 서비스 포트 : 데이터베이스 서비스 포트 (기본값 - 1433)
 - 형식
   - {호스트 이름}[:{포트}]
   - 예시
-    - "localhost:5432"
+    - "localhost:1433"
     - "localhost"
-    - "192.168.0.1:5432"
+    - "192.168.0.1:1433"
 
 ## 매개변수
 
 ### 사용자
 
-- mssql 데이터베이스의 사용자 ID
+- MS-SQL 데이터베이스의 사용자 ID
 
 ### 비밀번호
 
-- mssql 데이터베이스의 사용자 비밀번호
+- MS-SQL 데이터베이스의 사용자 비밀번호
 
 ### 데이터베이스
 
@@ -36,3 +36,7 @@ mssql 엔진 호스트 이름과 서비스 포트
 ### 암호화
 
 - 암호화된 연결
+
+### 서버 인증서 신뢰
+
+- MS-SQL 서버에 설치된 SSL/TLS 인증서가 self-signed certificate 이더라도 신뢰할 지 여부

package/helps/integration/connector/mssql-connector.md

@@ -1,33 +1,33 @@
-# MSSql connector
+# MS-SQL connector
 
-## MSSql is
+## MS-SQL is
 
-[MSSql](https://www.microsoft.com/sql-server) is Microsoft SQL Server
+[MS-SQL](https://www.microsoft.com/sql-server) is Microsoft SQL Server
 
 ## Setting
 
 ### endpoint
 
-MSSql engine hostname and service port
+MS-SQL engine hostname and service port
 
 - hostname : database server host
-- service port : database service port (default - 5432)
+- service port : database service port (default - 1433)
 - format
   - {hostname}[:{port}]
   - eg.
-    - "localhost:5432"
+    - "localhost:1433"
     - "localhost"
-    - "192.168.0.1:5432"
+    - "192.168.0.1:1433"
 
 ## Parameters
 
 ### user
 
-- user id for MSSql database
+- user id for MS-SQL database
 
 ### password
 
-- user password for MSSql database
+- user password for MS-SQL database
 
 ### database
 
@@ -36,3 +36,7 @@ MSSql engine hostname and service port
 ### encrypt
 
 - encrypted connection
+
+### trust server certificate
+
+- whether the SSL/TLS certificate installed on the MS-SQL server is trustworthy, even if it is a self-signed certificate

package/helps/integration/connector/mssql-connector.ms.md

@@ -1,33 +1,33 @@
-# Penyambung MSSql
+# Penyambung MS-SQL
 
-## MSSql adalah
+## MS-SQL adalah
 
-[MSSql](https://www.microsoft.com/sql-server) adalah Microsoft SQL Server
+[MS-SQL](https://www.microsoft.com/sql-server) adalah Microsoft SQL Server
 
 ## Tetapan
 
 ### titik akhir
 
-Nama hos dan port perkhidmatan enjin MSSql
+Nama hos dan port perkhidmatan enjin MS-SQL
 
 - nama hos : hos pelayan pangkalan data
-- port perkhidmatan : port perkhidmatan pangkalan data (lalai - 5432)
+- port perkhidmatan : port perkhidmatan pangkalan data (lalai - 1433)
 - format
   - {nama hos}[:{port}]
   - contoh
-    - "localhost:5432"
+    - "localhost:1433"
     - "localhost"
-    - "192.168.0.1:5432"
+    - "192.168.0.1:1433"
 
 ## Parameter
 
 ### pengguna
 
-- ID pengguna untuk pangkalan data MSSql
+- ID pengguna untuk pangkalan data MS-SQL
 
 ### kata laluan
 
-- Kata laluan pengguna untuk pangkalan data MSSql
+- Kata laluan pengguna untuk pangkalan data MS-SQL
 
 ### pangkalan data
 
@@ -36,3 +36,7 @@ Nama hos dan port perkhidmatan enjin MSSql
 ### enkripsi
 
 - Sambungan terenkripsi
+
+### kepercayaan sijil pelayan
+
+- adakah sijil SSL/TLS yang dipasang di pelayan MS-SQL boleh dipercayai walaupun ia sijil yang ditandatangani sendiri

package/helps/integration/connector/mssql-connector.zh.md

@@ -1,33 +1,33 @@
-# MSSql连接器
+# MS-SQL连接器
 
-## MSSql是什么
+## MS-SQL是什么
 
-[MSSql](https://www.microsoft.com/sql-server)是Microsoft SQL Server
+[MS-SQL](https://www.microsoft.com/sql-server)是Microsoft SQL Server
 
 ## 设置
 
 ### 终端点
 
-MSSql引擎主机名和服务端口
+MS-SQL引擎主机名和服务端口
 
 - 主机名：数据库服务器主机
-- 服务端口：数据库服务端口（默认 - 5432）
+- 服务端口：数据库服务端口（默认 - 1433）
 - 格式
   - {主机名}[:{端口}]
   - 例如
-    - "localhost:5432"
+    - "localhost:1433"
     - "localhost"
-    - "192.168.0.1:5432"
+    - "192.168.0.1:1433"
 
 ## 参数
 
 ### 用户
 
-- MSSql数据库的用户ID
+- MS-SQL数据库的用户ID
 
 ### 密码
 
-- MSSql数据库的用户密码
+- MS-SQL数据库的用户密码
 
 ### 数据库
 
@@ -36,3 +36,7 @@ MSSql引擎主机名和服务端口
 ### 加密
 
 - 加密连接
+
+### 服务器证书信任
+
+- MS-SQL 服务器安装的 SSL/TLS 证书是否值得信赖，即使是自签名证书

package/helps/integration/connector/operato-connector.ja.md

@@ -25,13 +25,10 @@ GraphQLサーバーエンドポイントを指定します。
 
 - 対象サーバーで動作させたいドメインを指定する必要があります。
 
-
 ### タグ
 
 - ターゲットサーバーで pubsub ベースのデータを購読する際に使用されるタグ名を指定します。
 
-
 ### 场景
 
 - タグが設定されている場合、購読されたメッセージを処理するシナリオを指定します。
-

package/helps/integration/task/script.ja.md

@@ -6,7 +6,7 @@
 
 - script
   - JavaScript 構文で記述します。
-  - グローバルオブジェクトは、対応する[シナリオコンテキスト](../concept/scenario-context.md)からのデータと変数を含むシンプルなオブジェクトです。つまり、スクリプト内では、シナリオの[スクリプト内蔵変数](../concept/script-internal-variables.md)から特別な修飾子なしで、または`this`アクセサを介してデータ、変数、ドメイン、ユーザー、lng 変数を使用できます。
+  - グローバルオブジェクトは、対応する[シナリオコンテキスト](../concept/scenario-context.md)からのデータと変数を含むシンプルなオブジェクトです。つまり、スクリプト内では、シナリオの[スクリプト内蔵変数](../concept/script-internal-variables.md)から特別な修飾子なしで、または`this`アクセサを介して data, variables, domain, user, lng, logger 変数を使用できます。
   - タスクの実行結果は`return`構文を介して返されます。
   - スクリプト内のグ
 

package/helps/integration/task/script.ko.md

@@ -6,7 +6,7 @@ Javascript Syntax로 작성된 script를 실행하여 그 결과를 리턴하는
 
 - script
   - javascript systax로 작성한다.
-  - global 오브젝트는 해당된 [Scenario Context](../concept/scenario-context.md)중 data 와 variables 를 가진 단순한 오브젝트이다. 즉, 스크립트 내에서 해당된 시나리오의 [스크립트 내장변수](../concept/script-internal-variables.md)인 data, variables, domain, user, lng 변수를 특별한 수식자없이 또는 this 접근자를 통해서 사용할 수 있다.
+  - global 오브젝트는 해당된 [Scenario Context](../concept/scenario-context.md)중 data 와 variables 를 가진 단순한 오브젝트이다. 즉, 스크립트 내에서 해당된 시나리오의 [스크립트 내장변수](../concept/script-internal-variables.md)인 data, variables, domain, user, lng, logger 변수를 특별한 수식자없이 또는 this 접근자를 통해서 사용할 수 있다.
   - 태스크의 수행 결과는 return 신택스를 통해서 반환된다.
   - script 내에서는 global 오브젝트가 data와 variables 등 [스크립트 내장변수](../concept/script-internal-variables.md)로 한정되므로, 대부분의 시스템 관련된 기능은 사용할 수 없는 sandbox 환경이라고 이해하고, 단순한 연산정도의 기능을 구현하는 것을 권장한다.
     - [Node Sandbox](https://medium.com/@devnullnor/a-secure-node-sandbox-f23b9fc9f2b0)

package/helps/integration/task/script.md

@@ -6,7 +6,7 @@ This is a task that executes a script written in JavaScript syntax and returns t
 
 - script
   - Write in JavaScript syntax.
-  - The global object is a simple object that contains data and variables from the corresponding [Scenario Context](../concept/scenario-context.md). In other words, within the script, you can use the data, variables, domain, user, and lng variables from the scenario's [Script Built-in Variables](../concept/script-internal-variables.md) without any special modifiers or through the `this` accessor.
+  - The global object is a simple object that contains data and variables from the corresponding [Scenario Context](../concept/scenario-context.md). In other words, within the script, you can use the data, variables, domain, user, logger and lng variables from the scenario's [Script Built-in Variables](../concept/script-internal-variables.md) without any special modifiers or through the `this` accessor.
   - The task's execution result is returned through the `return` syntax.
   - Since the global object within the script is limited to data and variables, as well as other [Script Built-in Variables](../concept/script-internal-variables.md), consider it a sandbox environment where most system-related functionalities are unavailable. It's recommended to implement simple operations.
     - [Node Sandbox](https://medium.com/@devnullnor/a-secure-node-sandbox-f23b9fc9f2b0)

package/helps/integration/task/script.ms.md

@@ -6,7 +6,7 @@ Ini adalah tugas yang menjalankan skrip yang ditulis dalam sintaks JavaScript da
 
 - skrip
   - Ditulis dalam sintaks JavaScript.
-  - Objek global adalah objek sederhana yang mengandungi data dan pembolehubah dari [Konteks Senario](../concept/scenario-context.md) yang berkaitan. Dengan kata lain, dalam skrip ini, anda boleh menggunakan data, pembolehubah, domain, pengguna, dan pembolehubah lng dari [Pembolehubah Terbina Dalam Skrip](../concept/script-internal-variables.md) senario tanpa modifier khas atau melalui aksesori `this`.
+  - Objek global adalah objek sederhana yang mengandungi data dan pembolehubah dari [Konteks Senario](../concept/scenario-context.md) yang berkaitan. Dengan kata lain, dalam skrip ini, anda boleh menggunakan data, variables, domain, user, lng, logger dari [Pembolehubah Terbina Dalam Skrip](../concept/script-internal-variables.md) senario tanpa modifier khas atau melalui aksesori `this`.
   - Hasil pelaksanaan tugas dikembalikan melalui sintaks `return`.
   - Oleh kerana objek global dalam skrip terhad kepada data dan pembolehubah, serta Pembolehubah Terbina Dalam Skrip yang lain, pertimbangkan ia sebagai persekitaran sandbox di mana kebanyakan fungsi berkaitan sistem tidak tersedia. Disarankan untuk melaksanakan operasi yang ringkas.
     - [Node Sandbox](https://medium.com/@devnullnor/a-secure-node-sandbox-f23b9fc9f2b0)

package/helps/integration/task/script.zh.md

@@ -6,7 +6,7 @@
 
 - 脚本
   - 以 JavaScript 语法编写。
-  - 全局对象是一个简单的对象，包含来自相应[场景上下文](../concept/scenario-context.md)的数据和变量。换句话说，在脚本内部，您可以使用来自场景的[脚本内置变量](../concept/script-internal-variables.md)（例如 data、variables、domain、user 和 lng 变量）而无需任何特殊修饰符，或者通过`this`访问器。
+  - 全局对象是一个简单的对象，包含来自相应[场景上下文](../concept/scenario-context.md)的数据和变量。换句话说，在脚本内部，您可以使用来自场景的[脚本内置变量](../concept/script-internal-variables.md)（例如 data、variables、domain、user, logger 和 lng 变量）而无需任何特殊修饰符，或者通过`this`访问器。
   - 任务的执行结果通过`return`语法返回。
   - 由于脚本内的全局对象仅限于数据和变量以及其他[脚本内置变量](../concept/script-internal-variables.md)，请将其视为一个沙盒环境，在该环境中大多数与系统相关的功能不可用。建议实现简单的操作。
     - [Node Sandbox](https://medium.com/@devnullnor/a-secure-node-sandbox-f23b9fc9f2b0)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/integration-base",
-  "version": "7.0.0-alpha.8",
+  "version": "7.0.0",
   "main": "dist-server/index.js",
   "browser": "client/index.js",
   "things-factory": true,
@@ -26,22 +26,23 @@
   },
   "dependencies": {
     "@apollo/client": "^3.6.9",
-    "@things-factory/api": "^7.0.0-alpha.8",
-    "@things-factory/auth-base": "^7.0.0-alpha.8",
-    "@things-factory/env": "^7.0.0-alpha.0",
-    "@things-factory/oauth2-client": "^7.0.0-alpha.8",
-    "@things-factory/scheduler-client": "^7.0.0-alpha.8",
-    "@things-factory/shell": "^7.0.0-alpha.8",
-    "@things-factory/utils": "^7.0.0-alpha.0",
+    "@operato/moment-timezone-es": "^7.0.0",
+    "@things-factory/api": "^7.0.0",
+    "@things-factory/auth-base": "^7.0.0",
+    "@things-factory/cache-service": "^7.0.0",
+    "@things-factory/env": "^7.0.0",
+    "@things-factory/oauth2-client": "^7.0.0",
+    "@things-factory/scheduler-client": "^7.0.0",
+    "@things-factory/shell": "^7.0.0",
+    "@things-factory/utils": "^7.0.0",
     "async-mqtt": "^2.5.0",
     "chance": "^1.1.11",
     "cross-fetch": "^3.0.4",
     "ieee754": "^1.2.1",
-    "moment-timezone": "^0.5.40",
     "node-fetch": "^2.6.0",
     "promise-socket": "^7.0.0",
     "readline": "^1.3.0",
-    "vm2": "3.9.11"
+    "ses": "^1.5.0"
   },
-  "gitHead": "b4981ea2721e7eaf4dbd618b6c77316ebc000ee5"
+  "gitHead": "00f3917ca132679e3571f3f4fd16f4caf84f488e"
 }

package/server/controllers/scenario-controller.ts

@@ -1,14 +1,22 @@
 import { getRepository, Domain, GraphqlLocalClient } from '@things-factory/shell'
-import { PrivilegeObject, checkPermission } from '@things-factory/auth-base'
+import { PrivilegeObject, User, checkPermission } from '@things-factory/auth-base'
+import { cacheService } from '@things-factory/cache-service'
 
 import { ScenarioEngine } from '../engine/scenario-engine'
 import { Scenario } from '../service/scenario/scenario'
-import { ScenarioInstance } from '../service/scenario-instance/scenario-instance-type'
+import {
+  ScenarioInstance,
+  ScenarioInstanceRunResult,
+  ScenarioInstanceStatus
+} from '../service/scenario-instance/scenario-instance-type'
 import { Step } from '../service/step/step-type'
 
 const debug = require('debug')('things-factory:integration-base:controller:run-scenario')
 
-async function findScenario(scenarioName: string, domain: Domain): Promise<{ name: string; steps: Step[]; domain: Domain; privilege?: PrivilegeObject }> {
+async function findScenario(
+  scenarioName: string,
+  domain: Domain
+): Promise<{ id: string; name: string; steps: Step[]; domain: Domain; privilege?: PrivilegeObject; ttl?: number }> {
   var repository = getRepository(Scenario)
 
   var scenario = await repository.findOne({
@@ -26,7 +34,12 @@ async function findScenario(scenarioName: string, domain: Domain): Promise<{ nam
   return scenario as any
 }
 
-export async function runScenario(instanceName: string, scenarioName: string, variables: any, context: ResolverContext): Promise<ScenarioInstance> {
+export async function runScenario(
+  instanceName: string,
+  scenarioName: string,
+  variables: any,
+  context: ResolverContext
+): Promise<ScenarioInstanceRunResult> {
   const { domain, user, lng, unsafeIP, prohibitedPrivileges } = context.state
 
   debug('runScenario', scenarioName, instanceName, variables)
@@ -43,7 +56,23 @@ export async function runScenario(instanceName: string, scenarioName: string, va
 
   if (!(await checkPermission(scenario.privilege, user, domain, unsafeIP, prohibitedPrivileges))) {
     const { category, privilege } = scenario.privilege || {}
-    throw new Error(`Unauthorized! ${category && privilege ? category + ':' + privilege + ' privilege' : 'ownership granted'} required`)
+
+    console.error(
+      `Unauthorized! ${category && privilege ? category + ':' + privilege + ' privilege' : 'ownership granted'} required`
+    )
+
+    throw new Error(
+      context.t('error.scenario run unauthorized', {
+        scenario: scenarioName
+      })
+    )
+  }
+
+  if (scenario.ttl > 0) {
+    const cachedValue = await cacheService.getFromCache(scenario.id, { domain: domain.id, variables: variables || {} })
+    if (cachedValue) {
+      return cachedValue.value
+    }
   }
 
   /* 시나리오 인스턴스를 생성한다. */
@@ -56,12 +85,25 @@ export async function runScenario(instanceName: string, scenarioName: string, va
     client: GraphqlLocalClient.client
   })
 
-  await instance.run()
+  try {
+    return await instance.run()
+  } catch (err) {
+    console.error(err)
 
-  return instance
+    throw new Error(
+      context.t('error.scenario run error', {
+        scenario: scenarioName
+      })
+    )
+  }
 }
 
-export async function startScenario(instanceName: string, scenarioName: string, variables: any, context: ResolverContext): Promise<ScenarioInstance> {
+export async function startScenario(
+  instanceName: string,
+  scenarioName: string,
+  variables: any,
+  context: ResolverContext
+): Promise<ScenarioInstance> {
   const { domain, user, lng, unsafeIP, prohibitedPrivileges } = context.state
 
   debug('startScenario', instanceName, scenarioName, variables)
@@ -78,14 +120,19 @@ export async function startScenario(instanceName: string, scenarioName: string,
 
   if (!(await checkPermission(scenario.privilege, user, domain, unsafeIP, prohibitedPrivileges))) {
     const { category, privilege } = scenario.privilege || {}
-    throw new Error(`Unauthorized! ${category && privilege ? category + ':' + privilege + ' privilege' : 'ownership granted'} required`)
+    throw new Error(
+      `Unauthorized! ${category && privilege ? category + ':' + privilege + ' privilege' : 'ownership granted'} required`
+    )
   }
 
   instanceName = instanceName || scenarioName
   return await ScenarioEngine.load(instanceName, scenario, { domain, user, lng, variables })
 }
 
-export async function stopScenario(instanceName: string, context: ResolverContext): Promise<ScenarioInstance | undefined> {
+export async function stopScenario(
+  instanceName: string,
+  context: ResolverContext
+): Promise<ScenarioInstance | undefined> {
   const { domain, user, unsafeIP, prohibitedPrivileges } = context.state
 
   debug('stopScenario', instanceName)
@@ -107,7 +154,9 @@ export async function stopScenario(instanceName: string, context: ResolverContex
 
   if (!(await checkPermission(scenario.privilege, user, domain, unsafeIP, prohibitedPrivileges))) {
     const { category, privilege } = scenario.privilege || {}
-    throw new Error(`Unauthorized! ${category && privilege ? category + ':' + privilege + ' privilege' : 'ownership granted'} required`)
+    throw new Error(
+      `Unauthorized! ${category && privilege ? category + ':' + privilege + ' privilege' : 'ownership granted'} required`
+    )
   }
 
   await ScenarioEngine.unload(domain, instanceName)