@aj-shadow/actorjs-documentation-text 0.0.0-aj-beta.221

package/LICENSE.txt

@@ -0,0 +1,96 @@
+
+LICENSE AGREEMENT
+
+Effective: 1st of November 2020
+This License Agreement is between Licensee and Hagnell Konsulting AB (a company incorporated in Sweden with
+company registration number: 559476-0570) (“Hagnell Konsulting”) and governs the use by Licensee of ActorJs
+(as defined below).
+By installing the Software (as defined below), Licensee agrees to be bound by the terms of this License Agreement.
+
+DEFENITIONS
+ActorJs The test tool developed by Hagnell Konsulting, utilizing the Patent and the Software.
+Derivative Works Any work, whether in source or object code, which is based on the Software and which
+does not constitute a new and independent work pursuant to paragraph 2 of article 4 of
+the Swedish Act (1960:729) on Copyright in Literary and Artistic Works.
+Documentation The manuals and instruction materials furnished by Hagnell Konsulting in connection
+with ActorJs.
+Licensee The physical or legal person to which the License hereunder has been granted by
+Hagnell Konsulting.
+Patent The patent application for a system and method for testing of systems under test, patent
+application number:19218798.7 (European Patent Office).
+Software The software developed and owned by Hagnell Konsulting, identified as ActorJs.
+
+§ 1 - LICENSE
+Licensee is hereby granted a limited, non-exclusive and non-transferable license to use ActorJs (including any
+Derivative Works created by Licensee hereunder) (the “License”). The License is granted subject to the terms and
+conditions set forth below.
+The Software is licensed to Licensee on an open source basis. The License includes the right to create Derivative
+Works pursuant to sub-clause 3 below.
+ActorJs may be used only by Licensee himself/herself/itself, or (if, for instance, Licensee is a company), by the
+employees and consultants of Licensee.
+The License does not include any updates to the Software, or any support services. Notwithstanding the foregoing,
+should Hagnell Konsulting furnish any updates to Licensee, such updates shall be subject to the License granted hereunder.
+As regards the Documentation provided by Hagnell Konsulting, Licensee may use this Documentation for the purpose of
+ the License hereunder (only). Licensee shall not be entitled to distribute copies of the Documentation, or electronically
+ communicate the Documentation, to recipients who are not employees or consultants of Licensee.
+
+§ 2 - LICENSE RESTRICTIONS
+Licensee may not:
+i) Rent, lease, lend, sell, distribute, transfer or otherwise make available ActorJs (and/or a Derivative Work)
+(whether for value or otherwise) to third parties without Hagnell Konsulting´s written approval. Any such approval
+will be subject to the third party acknowledging in writing (vis-à-vis Hagnell Konsulting) that its use of ActorJs
+(and/or the Derivative Work) shall be subject to the terms and conditions of this Agreement.
+
+ii) Distribute copies of the Software (and/or a Derivate Work), or electronically communicate the Software
+(and/or a Derivative Work), to recipients who are not employees or consultants of Licensee.
+
+§ 3 – DERITATIVE WORKS
+Should Licensee, or (if applicable) any of its employees or consultants, create a Derivative Work, Licensee shall
+inform Hagnell Konsulting thereof in writing (an e-mail shall be sufficient). Licensee may use the Derivative Work to the
+same extent as it may use the Software hereunder, but Hagnell Konsulting shall be the sole and exclusive owner of any
+and all rights in the Derivative Work, including the copyright. At the request of Hagnell Konsulting, Licensee and
+Hagnell Konsulting shall formalize the rights transfer in a written contract, which shall, inter alia, confirm that all rights
+in the Derivative Work have been irrevocably transferred to Hagnell Konsulting, that Hagnell Konsulting is be entitled to
+exploit the Derivative Work without limitation in time or any other kind of limitation, that Hagnell Konsulting may transfer
+its rights to the Derivative Work to third parties and that the rights transfer from Licensee to Hagnell Konsulting shall be
+free of charge.
+
+§ 4 – IMPROVEMENTS TO THE PATENT
+Any improvement to the Patent, whether patentable or not, which Licensee, or (if applicable) any of its employees or
+consultants, may discover, create or develop or otherwise have at its disposal, directly or indirectly, without restraints
+as to the use thereof (“Improvements”), shall be disclosed promptly to Hagnell Konsulting and Hagnell Konsulting shall
+have the exclusive right of perpetual duration to use the Improvements as well as to grant the use thereof to other licensees
+in the whole world without compensation to Licensee, except that Licensee shall during the life of this Agreement have
+the non-exclusive right to use such Improvements including corresponding patents, if any, in accordance with the
+provisions of this Agreement. If Licensee decides not to apply for a patent relating to an Improvement made by
+Licensee or if Licensee no longer wishes to maintain such a patent or patent application then Hagnell Konsulting may in its
+sole discretion and at its own expense apply for such a patent or maintain such a patent or patent application (as the
+case may be).
+
+§ 5 - COPYRIGHT AND INTELLECTUAL PROPERTY RIGHTS
+The Software, the Patent and the Documentation are protected by copyright and patent laws and international
+copyright and patent treaties, as well other intellectual property laws and treaties. Any such intellectual property
+rights are owned and especially reserved by Hagnell Konsulting, without limitation. For the avoidance of doubt, no
+ownership rights are transferred to Licensee hereunder.
+“ActorJs” is a registered trademark of Hagnell Konsulting. This Agreement does not include a license to use the
+trademark “ActorJs”.
+
+§ 6 - LIMITITATION ON LIABILITY
+ActorJs is licensed to Licensee “as is”. Hagnell Konsulting gives no guarantees as regards the use, functionality
+or performance of ActorJs and assumes no liability (whatsoever) as regards any defaults in ActorJs or any possible
+infringements on third party statutory or contractual rights. Hagnell Konsulting expressly disclaims any and all warranties
+not expressly given in this Agreement, including any implied warranties of merchantability, satisfactory quality, fitness
+for a particular purpose, title and non-infringement. Thus, the entire risk arising out of any use of ActorJs hereunder
+remains with Licensee.
+The limitation of liability hereunder shall be to the maximum extent permitted by applicable law. Under no
+circumstances shall Hagnell Konsulting be liable for any cost of substitute products or services, for any indirect losses or
+for any consequential damages (including any loss of profits, interruptions or loss of business information).
+
+§ 7 - MISCELLANEOUS
+Licensee may not, either wholly or partly, assign or pledge its rights or obligations under this Agreement to any third
+party without the prior written consent of Hagnell Konsulting.
+
+§ 8 - DISPUTES
+This agreement shall be governed by Swedish law. Any dispute, controversy or claim arising out of or in connection
+with this contract, or the breach, termination or invalidity thereof, shall be settled by the general courts of Sweden,
+with the district court of Stockholm in the first instance. 

package/README.md

@@ -0,0 +1,5 @@
+# README #
+
+# ActorJs
+
+**Library used by @actorjs/actorjs**

package/Workshop/Document-global-actordemo-image-ai.txt

@@ -0,0 +1,5 @@
+# **Image AI page**
+The [ActorDemo](http://localhost:9045/image-ai) Image AI page shows images and buttons to transform the images.
+
+<br />
+<img class="markup_image" onclick="if('100%' === this.style.width) {this.style.width = '233px';} else {this.style.width = '100%';}" src="/abs-images/images/workshop/ActorDemoImageAI.png" style="width:100%; margin: 0px 16px 10px;">

package/Workshop/Document-global-actordemo-login.txt

@@ -0,0 +1,10 @@
+# **Login page**
+The [ActorDemo](http://localhost:9045/start) login page contains either a login box or a logout box.
+
+---
+## **Login**
+<img class="markup_image" onclick="if('100%' === this.style.width) {this.style.width = '233px';} else {this.style.width = '100%';}" src="/abs-images/images/workshop/ActorDemoLogin.png" style="width:100%; margin: 0px 16px 10px;">
+
+---
+## **Logout**
+<img class="markup_image" onclick="if('100%' === this.style.width) {this.style.width = '233px';} else {this.style.width = '100%';}" src="/abs-images/images/workshop/ActorDemoLogout.png" style="width:100%; margin: 0px 16px 10px;">

package/Workshop/Document-global-actordemo-site.txt

@@ -0,0 +1,3 @@
+# **ActorDemo site**
+**ActorDemo** is a simple site where you can use an AI service to transform images.
+The site can be configured to use authorization. If authorization is turned on, the user must login to be able to use the service.

package/Workshop/Document-global-actordemo-start.txt

@@ -0,0 +1,5 @@
+# **Start page**
+The [ActorDemo](http://localhost:9045/start) start page contains a simple example of what the Image AIService can do.
+
+<br />
+<img class="markup_image" onclick="if('100%' === this.style.width) {this.style.width = '233px';} else {this.style.width = '100%';}" src="/abs-images/images/workshop/ActorDemoStart.png" style="width:100%; margin: 0px 16px 10px;">

package/Workshop/Document-global-actordemo-the-architecture.txt

@@ -0,0 +1,27 @@
+# **The Architecture**
+## **Description**
+The architecture of **ActorDemo** is a bit exaggerated to show the possibilities of ActorJs.
+
+```node
+Config(nodeWidth: 80, nodeHeight: 80, nodeWidthBetween: 25, nodeHeightBetween: 40, widthBias: 30, heightBias: 40, border: true, backgroundColor: AliceBlue)
+
+Nodes[, , , , UserService(; ; White)]
+Nodes[Browser(; ; White), , ActorDemo(; ; Honeydew), , ImageService(; ; White)]
+Nodes[, , , , AIService(; ; White)]
+
+Groups[Actor Orig(0; 1; 0; 3), SUT(2; 3; 0; 3), Actor Term(4; 5; 0; 3)]
+
+Browser => ActorDemo[puppeteer]: puppeteer
+Browser => ActorDemo[http]: http
+Browser => ActorDemo[websocket]: websocket
+ActorDemo => UserService[http]: http
+ActorDemo => ImageService[http]: http
+ActorDemo => AIService[icap]: icap
+```
+
+### **Nodes**
+* **Browser**: the client to use **ActorDemo**.
+* **ActorDemo**: the [[REF=, ABS_System_Under_Test]]. It is a web server containing the site and a REST API.
+* **UserService**: a service handling user data, such as logins.
+* **ImageService**: a service handling images.
+* **AIService**: a service handling image transformations.

package/Workshop/Document-global-introduction-actor.txt

@@ -0,0 +1,84 @@
+# **Introduction - Actor**
+## **What is an Actor?**
+An [[REF=, ABS_Actor]] is the fundamental building block of ActorJs. An [[REF=, ABS_Actor]] is a simulated process that is controlled by ActorJs, which starts, stops, and interrupts [[REF=, ABS_Actors]] depending on the data and outcome of the [[REF=, ABS_Test_Case]].
+
+An [[REF=, ABS_Actor]] is 100% code, which gives the test developer full control. For maximal reuse and optimal maintenance, [[REF=, ABS_Actors]] have their own:
+* Logic
+* Flow
+
+ActorJs will provide Actors with:
+* [[REF=, ABS_Addresses]]
+* [[REF=, ABS_Test_Data]]
+* [[REF=, ABS_Verification_Data]]
+* [[REF=, ABS_Content]]
+
+[[REF=, ABS_Actors]] use [[REF=, ABS_Stacks]] to communicate. A [[REF=, ABS_Test_Case]] contains [[REF=, ABS_Actors]] to isolate the [[REF=, ABS_System_Under_Test]]. An [[REF=, ABS_Actor]] can be reused over and over again in different [[REF=, ABS_Test_Cases]], and can change its behavior in response to the [[REF=, ABS_Test_Data]].
+
+## **Analyze**
+Let's say we have a system to test, containing a browser, a proxy, and a web server.
+```node
+Config(nodeWidth: 70, nodeHeight: 70, nodeWidthBetween: 25, nodeHeightBetween: 45, widthBias: 30, heightBias: 30)
+
+Nodes[Browser, , Proxy, , web-server]
+
+Groups[STT(0; 5; 0; 1)]
+
+Browser => Proxy[http]: http
+Proxy => web-server[http]: http
+```
+If we want to test the proxy, we define it as the [[REF=, ABS_System_Under_Test]]. Then we simulate the browser and the web server with [[REF=, ABS_Actors]].
+```node
+Config(nodeWidth: 70, nodeHeight: 70, nodeWidthBetween: 25, nodeHeightBetween: 45, widthBias: 30, heightBias: 30)
+
+Nodes[Browser, , Proxy, , web-server]
+
+Groups[Actor Orig(0; 1; 0; 1), SUT(2; 3; 0; 1), Actor Term(4; 5; 0; 1)]
+
+Browser => Proxy[http]: http
+Proxy => web-server[http]: http
+```
+We want to test a situation where the browser fetches an image from the web server via the proxy. The use case looks like this:
+```seq
+Config(nodeWidth: 150, nodeMessageHeight: 17, nodeEventHeight: 10, widthBias: 30, heightBias: 30, lineNumbers: false, border: true, backgroundColor: default)
+
+Nodes[Browser, Proxy, web-server]
+Browser => Proxy[http]: Get /image.png
+Proxy => web-server[http]: Get /image.png
+web-server => Proxy[http]: 200 OK
+Proxy => Browser[http]: 200 OK
+```
+To implement this use case, we need:
+* an HTTP Stack
+* an http get image request message
+* an http get image response message
+
+Once these items are in place, all we have to do is implement the [[REF=, ABS_Actors]].
+1) The browser [[REF=, ABS_Actor]] sends a request and receives a response.
+2) The web server [[REF=, ABS_Actor]] receives a request and sends a response.
+
+## **Implement**
+Minimal code is needed to implement simple [[REF=, ABS_Actors]]. We recommend keeping [[REF=, ABS_Actors]] simple, letting them implement only part of the flow in the use case. An [[REF=, ABS_Actor]] can implement a whole simulator, of course, but this would not provide any advantage over using a conventional simulator.
+#### Browser
+```javascript
+
+*run() {
+  this.httpConnection.send(new HttpMsgGetRequest(this.requistUri));
+  const response = this.httpConnection.receive();
+}
+
+```
+#### **Web server**
+```javascript
+
+*run() {
+  this.httpConnection.accept();
+  const request = this.httpConnection.receive();
+  this.httpConnection.send(new HttpGet200OkResponse(this.content));
+}
+
+```
+
+# **Tools**
+The Actors tool is an editor to build [[REF=, ABS_Actors]].
+
+<img class="markup_image" onclick="if('100%' === this.style.width) {this.style.width = '233px';} else {this.style.width = '100%';}" src="/abs-images/images/visualization/actors.png" style="width: 100%; margin: 0px 16px 10px;">

package/Workshop/Document-global-introduction-actorjs.txt

@@ -0,0 +1,42 @@
+# **Introduction - ActorJs**
+
+<div style="position:relative;display:flex;flex-direction:column;float:right">
+  <h4 style="width: 233px; margin: 0px 16px 10px; font-weight:bold;">Core Tool - Repos</h3>
+  <img class="markup_image" onclick="if('100%' === this.style.width) {this.style.width = '233px';} else {this.style.width = '100%';}" src="/abs-images/images/visualization/repos.png" style="width: 233px; margin: 0px 16px 10px;">
+  <h4 style="width: 233px; margin: 2px 16px 10px; font-weight:bold;">Core Tool - SUTs</h3>
+  <img class="markup_image" onclick="if('100%' === this.style.width) {this.style.width = '233px';} else {this.style.width = '100%';}" src="/abs-images/images/visualization/sut.png" style="width: 233px; margin: 0px 16px 10px;">
+  <h4 style="width: 233px; margin: 0px 16px 10px; font-weight:bold;">Core Tool - Test Suits</h3>
+  <img class="markup_image" onclick="if('100%' === this.style.width) {this.style.width = '233px';} else {this.style.width = '100%';}" src="/abs-images/images/visualization/test-suite-execution.png" style="width: 233px; margin: 0px 16px 10px;">
+  <h4 style="width: 233px; margin: 0px 16px 10px; font-weight:bold;">Core Tool - Test Cases</h3>
+  <img class="markup_image" onclick="if('100%' === this.style.width) {this.style.width = '233px';} else {this.style.width = '100%';}" src="/abs-images/images/visualization/test-case-definition.png" style="width: 233px; margin: 0px 16px 10px;">
+  <h4 style="width: 233px; margin: 0px 16px 10px; font-weight:bold;">Core Tool - Actors</h3>
+  <img class="markup_image" onclick="if('100%' === this.style.width) {this.style.width = '233px';} else {this.style.width = '100%';}" src="/abs-images/images/visualization/actors.png" style="width: 233px; margin: 0px 16px 10px;">
+  <h4 style="width: 233px; margin: 0px 16px 10px; font-weight:bold;">Core Tool - Stacks</h3>
+  <img class="markup_image" onclick="if('100%' === this.style.width) {this.style.width = '233px';} else {this.style.width = '100%';}" src="/abs-images/images/visualization/stacks.png" style="width: 233px; margin: 0px 16px;">
+  <h4 style="width: 233px; margin: 0px 16px 10px; font-weight:bold;">Data Tool - Address</h3>
+  <img class="markup_image" onclick="if('100%' === this.style.width) {this.style.width = '233px';} else {this.style.width = '100%';}" src="/abs-images/images/visualization/address.png" style="width: 233px; margin: 0px 16px;">
+  <h4 style="width: 233px; margin: 0px 16px 10px; font-weight:bold;">Data Tool - Test Data</h3>
+  <img class="markup_image" onclick="if('100%' === this.style.width) {this.style.width = '233px';} else {this.style.width = '100%';}" src="/abs-images/images/visualization/test-data.png" style="width: 233px; margin: 0px 16px;">
+  <h4 style="width: 233px; margin: 0px 16px 10px; font-weight:bold;">Data Tool - Content</h3>
+  <img class="markup_image" onclick="if('100%' === this.style.width) {this.style.width = '233px';} else {this.style.width = '100%';}" src="/abs-images/images/visualization/content.png" style="width: 233px; margin: 0px 16px;">
+</div>
+
+ActorJs is an integrated test - development environment. It contains tools, organizes data, and provides several views that visualize logs, sequence diagrams, and more in real time.
+
+## **Core Tools**
+* [[REF=, ABS_Repos]] - manages your [[REF=, ABS_Repos]].
+* [[REF=, ABS_SUTs]] - manages your [[REF=, ABS_SUTs]].
+* [[REF=, ABS_Test_Suites]] - manages and execute [[REF=, ABS_Test_Suites]].
+* [[REF=, ABS_Test_Cases]] - manages and execute [[REF=, ABS_Test_Cases]].
+* [[REF=, ABS_Stacks]] - editor to build [[REF=, ABS_Stacks]].
+* [[REF=, ABS_Actors]] - editor to build [[REF=, ABS_Actors]].
+
+## **Data Tools**
+* [[REF=, ABS_Addressing_Address]] - manages your [[REF=, ABS_Addressing]].
+* [[REF=, ABS_Test_Data]] - manages your [[REF=, ABS_Test_Data]].
+* [[REF=, ABS_Content]] - manages your [[REF=, ABS_Content]].
+* [[REF=, ABS_Load]] - manages your [[REF=, ABS_Load]]. `Coming soon`
+
+## **Visualization Tools**
+* Log
+* Sequence Diagram

package/Workshop/Document-global-introduction-stack.txt

@@ -0,0 +1,25 @@
+# **Introduction - Stack**
+## **What is a Stack?**
+A [[REF=, ABS_Stack]] is a group of components used to send and receive messages from an [[REF=, ABS_Actor]]. It is an implementation of a protocol, either a standard or proprietary protocol, or communication with hardware or a GUI. The [[REF=, ABS_Stack]] abstraction differs slightly from those commonly used when implementing protocols; it contains only an [[REF=, ABS_Encoder]] and [[REF=, ABS_Decoder]], and does not keep states or handle timers. These parts of a common stack will be implemented in [[REF=, ABS_Actors]] when needed.
+
+The components of a Stack are:
+* **[[REF=, ABS_Connection]]** - sends and receives messages
+* **[[REF=, ABS_Message]]** - a container of data from which data can be sent and to which data can be received
+* **[[REF=, ABS_Encoder]]** - encodes the data of a message to the chosen protocol
+* **[[REF=, ABS_Decoder]]** - decodes the selected protocol data to a message
+
+Some common stacks include: **Http**, **Diameter**, **Radius**, **Sip**, **MQTT**, and others.
+ 
+```node
+Config(nodeWidth: 90, nodeHeight: 40, nodeWidthBetween: 25, nodeHeightBetween: 45, widthBias: 30, heightBias: 30)
+
+Nodes[MessageS, Encoder, , Decoder, MessageR]
+
+Groups[Sending Actor(0; 1; 0; 1), Client Connection(1; 2; 0; 1), Server Connection(3; 4; 0; 1), Receiving Actor(4; 5; 0; 1)]
+
+MessageS => Encoder[]: 
+Encoder => Decoder[http]: 
+Decoder => MessageR[]: 
+```
+1) An [[REF=, ABS_Actor]] sends an [[REF=, ABS_Message]] with a [[REF=, ABS_Connection]] which encodes the [[REF=, ABS_Message]] to chosen protocol.
+1) A [[REF=, ABS_Connection]] receives an [[REF=, ABS_Message]] and decodes the protocol to a [[REF=, ABS_Message]] and returns it to the receiving [[REF=, ABS_Actor]].

package/Workshop/Document-global-introduction-system-under-test.txt

@@ -0,0 +1,102 @@
+# **Introduction - System Under Test**
+## **What is a System To Test?**
+
+When testing a system, we define the nodes/processes not handled by ActorJs as the [[REF=, ABS_System_Under_Test]]. The [[REF=, ABS_Actors]] - simulated processes - communicating with the [[REF=, ABS_System_Under_Test]] will be defined as the **Test Scenography**. The Test Scenography is divided into two parts: Actor Clients and Actor Servers.
+
+```node
+Config(nodeWidth: 50, nodeHeight: 50, nodeWidthBetween: 25, nodeHeightBetween: 40, widthBias: 30, heightBias: 30)
+
+Nodes[, Browser, , , ]
+Nodes[, , Sensor 1, , Core]
+Nodes[, , Sensor 2, , , ]
+
+Groups[Clients(0; 2; 0; 3), STT(2; 6; 0; 3)]
+
+Browser => Core[radius]: radius
+Browser => Core[http]: http
+Sensor 1 => Core[mqtt]: mqtt
+Sensor 2 => Core[mqtt]: mqtt
+```
+## **The detailed System To Test**
+The [[REF=, ABS_System_To_Test]] usually consists of many different nodes that either belong to the product or are third-party nodes on which the product is dependent.
+
+It can of interest to build test cases for the whole system, and that's what we'll do, but remember: **it will not be possible to test everything.** How can we perform different negative tests? How do we control the sensors? How can we control the third-party products? The answer is that we cannot.
+
+```node
+Config(nodeWidth: 50, nodeHeight: 50, nodeWidthBetween: 25, nodeHeightBetween: 25, widthBias: 30, heightBias: 30)
+
+Nodes[, , , , , ]
+Nodes[, Browser, , Login, , , , Hss, ]
+Nodes[, , , Frontend, , Backend, , WWW]
+Nodes[, , , Sensor 1, , , , Store]
+Nodes[, , , Sensor 2, , MQTT]
+
+Groups[Clients(0; 3; 0; 5), STT - Product(3; 6; 0; 5), STT - Third Party(6; 9; 0; 5)]
+
+Browser => Login[radius]: radius
+Browser => Frontend[http]: http
+Sensor 1 => MQTT[mqtt]: mqtt
+Sensor 2 => MQTT[mqtt]: mqtt
+Login => Hss[diameter]: diamter
+Frontend => Backend[socket]: socket
+MQTT => Backend[socket]: socket
+Backend => Hss[diameter]: diameter
+Backend => WWW[http]: http
+Backend => Store[socket]: socket
+```
+## **System Under Test**
+The [[REF=, ABS_System_To_Test]] can be divided into several [[REF=, ABS_System_Under_Test]]s. By definition, a [[REF=, ABS_System_Under_Test]] is either the whole [[REF=, ABS_System_To_Test]], or parts of it. 
+### **System Under Test - Core Product**
+1) Normally, it will not be necessary to test the third-party products. We can replace them with [[REF=, ABS_Actors]] instead.
+2) We can also replace sensors with [[REF=, ABS_Actors]].
+```node
+Config(nodeWidth: 50, nodeHeight: 50, nodeWidthBetween: 25, nodeHeightBetween: 40, widthBias: 30, heightBias: 30)
+
+Nodes[, , , , , ]
+Nodes[, Browser, , Login, , , , Hss, ]
+Nodes[, , , Frontend, , Backend, , WWW]
+Nodes[, Sensor 1, , MQTT, , , , Store, ]
+Nodes[, Sensor 2, , , ]
+
+Groups[Originating Actors(0; 3; 0; 5), SUT - Core Product(3; 6; 0; 5), Terminating Actor(6; 9; 0; 5)]
+
+Browser => Login[radius]: radius
+Browser => Frontend[http]: http
+Sensor 1 => MQTT[mqtt]: mqtt
+Sensor 2 => MQTT[mqtt]: mqtt
+Login => Hss[diameter]: diameter
+Frontend => Backend[socket]: socket
+MQTT => Backend[socket]: socket
+Backend => Hss[diameter]: diameter
+Backend => WWW[http]: http
+Backend => Store[socket]: socket
+```
+### **System Under Test - Login**
+1) The browser and Hss can be replaced with [[REF=, ABS_Actors]].
+```node
+Config(nodeWidth: 50, nodeHeight: 50, nodeWidthBetween: 25, nodeHeightBetween: 40, widthBias: 30, heightBias: 30)
+
+Nodes[Browser, , Login, , Hss]
+
+Groups[Originating Actors(0; 2; 0; 1), SUT - Login(2; 3; 0; 1), Terminating Actor(3; 5; 0; 1)]
+
+Browser => Login[radius]: radius
+Login => Hss[diameter]: diameter
+```
+### **System Under Test - Sensor 1**
+1) Sensor 1 can be tested by replacing the MQTT Node with [[REF=, ABS_Actors]].
+ ```node
+Config(nodeWidth: 50, nodeHeight: 50, nodeWidthBetween: 25, nodeHeightBetween: 45, widthBias: 30, heightBias: 30)
+
+Nodes[, Sensor 1, , MQTT, , ]
+
+Groups[SUT - Sensor 1(0; 3; 0; 1), Actor Servers(3; 6; 0; 1)]
+
+Sensor 1 => MQTT[mqtt]: mqtt
+```
+## **Conclusion**
+There is no limit to the number of [[REF=, ABS_System_Under_Test]] into which you can divide your [[REF=, ABS_System_To_Test]].
+
+Perhaps different development teams are developing each node. Then the teams can isolate their specific node with [[REF=, ABS_Actors]] and test it.
+
+Later, you can define two or more nodes as a [[REF=, ABS_System_To_Test]], reusing the previously developed [[REF=, ABS_Actors]], and test the nodes together - practically for free.

package/Workshop/Document-global-introduction-test-case.txt

@@ -0,0 +1,50 @@
+# **Introduction - Test Case**
+
+### **What is a Test Case?**
+
+A Test Case is 100% data driven. The data to provide is as follows:
+* [[REF=, ABS_Actors]]
+* [[REF=, ABS_Addressing]]
+* [[REF=, ABS_Test_Data]]
+* [[REF=, ABS_Verification_Data]]
+
+Even though a [[REF=, ABS_Test_Case]] is 100% data driven, you maintain 100% control of the code. The code is written as [[REF=, ABS_Actors]]. [[REF=, ABS_Actors]] determine what [[REF=, ABS_Test_Data]] and [[REF=, ABS_Verification_Data]] they need.
+
+
+### **Example**
+
+```tc
+|Actor                                                                                                    |
+|name                                |node|type|phase|execution|src    |dst  |srv   |testData|verification|
+|Actors-global.workshop.BrowserOrig  |    |orig|     |         |browser|proxy|      |        |            |
+|Actors-global.workshop.WebServerTerm|    |term|     |         |       |     |server|        |            |
+|                                    |    |    |     |         |       |     |      |        |            |
+
+|TestDataTestCase          |
+|key|value     |description|
+|url|/image.png|           |
+|   |          |           |
+```
+
+[[DIV={"id":"d624004c-5f2c-4c33-bf4d-d5f7dff9ddf4","style":{"float":"left"}}]]
+
+
+<div style="display: flex;flex-direction:column;float:right">
+  <h4 style="width: 233px; margin: 0px 16px 10px; font-weight:bold;">Tab - Definition</h3>
+  <img class="markup_image" onclick="if('100%' === this.style.width) {this.style.width = '233px';} else {this.style.width = '100%';}" src="/abs-images/images/visualization/test-case-definition.png" style="width: 233px; margin: 0px 16px 10px;">
+  <h4 style="width: 233px; margin: 0px 16px 10px; font-weight:bold;">Tab - Execution</h3>
+  <img class="markup_image" onclick="if('100%' === this.style.width) {this.style.width = '233px';} else {this.style.width = '100%';}" src="/abs-images/images/visualization/test-case-execution.png" style="width: 233px; margin: 0px 16px 10px;">
+  <h4 style="width: 233px; margin: 0px 16px 10px; font-weight:bold;">Tab - Log</h3>
+  <img class="markup_image" onclick="if('100%' === this.style.width) {this.style.width = '233px';} else {this.style.width = '100%';}" src="/abs-images/images/visualization/test-case-log.png" style="width: 233px; margin: 0px 16px 10px;">
+  <h4 style="width: 233px; margin: 0px 16px 10px; font-weight:bold;">Tab - Sequence Diagram</h3>
+  <img class="markup_image" onclick="if('100%' === this.style.width) {this.style.width = '233px';} else {this.style.width = '100%';}" src="/abs-images/images/visualization/test-case-sequence-diagram.png" style="width: 233px; margin: 0px 16px 10px;">
+  <h4 style="width: 233px; margin: 0px 16px 10px; font-weight:bold;">Tab - Debug</h3>
+  <img class="markup_image" onclick="if('100%' === this.style.width) {this.style.width = '233px';} else {this.style.width = '100%';}" src="/abs-images/images/visualization/test-case-debugging.png" style="width: 233px; margin: 0px 16px 10px;">
+  <h4 style="width: 233px; margin: 0px 16px 10px; font-weight:bold;">Tab - Specification</h3>
+  <img class="markup_image" onclick="if('100%' === this.style.width) {this.style.width = '233px';} else {this.style.width = '100%';}" src="/abs-images/images/visualization/test-case-specification.png" style="width: 233px; margin: 0px 16px 10px;">
+  <h4 style="width: 233px; margin: 0px 16px 10px; font-weight:bold;">Tab - Analyze</h3>
+  <img class="markup_image" onclick="if('100%' === this.style.width) {this.style.width = '233px';} else {this.style.width = '100%';}" src="/abs-images/images/visualization/test-case-analyze.png" style="width: 233px; margin: 0px 16px 10px;">
+</div>
+
+### **Core Tool - Test Cases**
+When working with a [[REF=, ABS_Test_Case]] there are several tabs with different functionality. 

package/Workshop/Document-global-introduction-test-suite.txt

@@ -0,0 +1,31 @@
+# **Introduction - Test Suite**
+
+### **What is a Test Suite?**
+
+A Test Suite is 100% data driven. The data to provide is:
+* [[REF=, ABS_Test_Cases]]
+* [[REF=, ABS_Test_Suites]]
+
+```ts
+|TestSuiteAbstraction                                                     |
+|name                                              |execution|iterationsTs|
+|tc.ImageService.Image.ImagePng-1-Message-Flow     |         |            |
+|tc.ImageService.Image.ImagePng-2-Test-Data-Denmark|         |            |
+|tc.ImageService.Image.ImagePng-2-Test-Data-Sweden |         |            |
+|                                                  |         |            |
+```
+
+[[DIV={"id":"d624004c-5f2c-4c33-bf4d-d5f7dff9ddf4","style":{"float":"left"}}]]
+
+
+<div style="display: flex;flex-direction:column;float:right">
+  <h4 style="width: 233px; margin: 0px 16px 10px; font-weight:bold;">Tab - Definitions</h3>
+  <img class="markup_image" onclick="if('100%' === this.style.width) {this.style.width = '233px';} else {this.style.width = '100%';}" src="/abs-images/images/visualization/test-suite-definition.png" style="width: 233px; margin: 0px 16px 10px;">
+  <h4 style="width: 233px; margin: 0px 16px 10px; font-weight:bold;">Tab - Execution</h3>
+  <img class="markup_image" onclick="if('100%' === this.style.width) {this.style.width = '233px';} else {this.style.width = '100%';}" src="/abs-images/images/visualization/test-suite-execution.png" style="width: 233px; margin: 0px 16px 10px;">
+  <h4 style="width: 233px; margin: 0px 16px 10px; font-weight:bold;">Tab - Log</h3>
+  <img class="markup_image" onclick="if('100%' === this.style.width) {this.style.width = '233px';} else {this.style.width = '100%';}" src="/abs-images/images/visualization/test-suite-log.png" style="width: 233px; margin: 0px 16px 10px;">
+</div>
+
+### **Core Tool - Test Cases**
+When working with a [[REF=, ABS_Test_Suite]] there are several tabs with different functionality. 

package/Workshop/Document-global-login-with-puppeter.txt

@@ -0,0 +1,45 @@
+# **2) Login with Puppeteer**
+
+#### **Purpose**
+Learn how to use a ***mock***, called [[REF=, ABS_Actor_Terminating]].
+#### **Task**
+**Description**:
+1) Load the ***ActorDemo*** site and click the ***"goto login"*** button.
+2) Type the ***username*** and the ***password***.
+3) Click the "login button.
+
+**Test type:** GUI test
+
+#### **Analyze**
+```node
+Config(nodeWidth: 80, nodeHeight: 50, nodeWidthBetween: 75, nodeHeightBetween: 25, widthBias: 30, heightBias: 30, border: true, backgroundColor: default)
+
+Nodes[Browser(; ; White), ActorDemo(; ; Honeydew), UserService(; ; White)]
+
+
+Browser => ActorDemo[http]: http
+ActorDemo => UserService[http]: http
+```
+
+* Create an [[REF=, ABS_Actor_Originating]] which uses the ***puppeteer*** stack.
+* Create an [[REF=, ABS_Actor_Terminating]] which uses the ***http*** stack.
+
+#### **Sequence Diagram**
+```seq
+Config(nodeWidth: 200, nodeMessageHeight: 17, nodeEventHeight: 10, nodeCommentHeight: 26, widthBias: 60, heightBias: 30, lineNumbers: false, border: true, backgroundColor: EAFEEA)
+
+Nodes[Browser, ActorDemo, UserService]
+Browser page [puppeteer]: 
+Browser -o ActorDemo[http]: 
+Browser => ActorDemo[http]: GET http://actordemo:9045/start
+ActorDemo => Browser[http]: 200 OK
+Browser click [puppeteer]: id = from_start_to_login
+Browser type [puppeteer]: id = actor_demo_username_input
+Browser type [puppeteer]: id = actor_demo_password_input
+Browser click [puppeteer]: id = actor_demo_login_button
+Browser => ActorDemo[http]: GET http://actordemo:9045/login
+ActorDemo => UserService[http]: GET
+UserService => ActorDemo[http]: 200 OK
+ActorDemo => Browser[http]: 200 OK
+Browser -x ActorDemo[http]: 
+```

package/Workshop/Document-global-mock-with-http.txt

@@ -0,0 +1,83 @@
+# **2) Mock with HTTP**
+
+---
+## ***Goto the Image AI page***
+
+---
+#### **Purpose**
+Learn how to ***mock*** with the [[REF=, STACK_HTTP]] stack. ***Mock*** with a [[REF=, ABS_Terminating_Actor]].
+Learn how to use ***[[REF=, ABS_Content]]*** with the [[REF=, API_Actor_Content]].
+
+---
+#### **Task**
+1) Mock ***ImageService*** and reply with  ***Justin***.
+2) Load the ***ActorDemo*** site and click the **"Goto:** Image AI**"** button.
+
+---
+#### **Analyze**
+```node
+Config(nodeWidth: 80, nodeHeight: 50, nodeWidthBetween: 75, nodeHeightBetween: 25, widthBias: 30, heightBias: 30, border: true, backgroundColor: default)
+
+Nodes[Browser(; ; White), ActorDemo(; ; Honeydew), ImageService(; ; White)]
+
+
+Browser => ActorDemo[http]: http
+ActorDemo => ImageService[http]: http
+```
+
+The ***Image AI*** page uses the backend node ImageService. 
+* [[REF=, STACK_HTTP]] is the protocol between the ***Browser*** and ***ActorDemo*** so we will use the [[REF=, STACK_PUPPETEER]] stack to test this page.
+* [[REF=, STACK_HTTP]] is the protocol between the ***ActorDemo*** and ***ImageService*** so we will use the [[REF=, STACK_HTTP]] stack to ***mock*** the ***ImageService***.
+
+  * The ***ImageService*** has two **REST API** methods.
+  * 1) **AiGetImages**:
+      1.1) **protocol**: HTTP
+      1.2) **Method**: GET
+      1.3) **url**: api/v1/image/get-images
+      1.4) **returns**: [[REF=, MDN_JSON]] - **content-type**: application/json
+        * [[REF=, MDN_objects]]: *Array of objects with image & AI data*
+        * **name**:  [[REF=, MDN_string]]: *Name of the image*
+        * **mime**:  [[REF=, MDN_string]]: *Image mime type*
+        * **aix**: [[REF=, MDN_strings]]: *Array of AI transformations*
+   * 2) **AiGetImage**
+      2.1) **protocol**: HTTP
+      2.2) **Method**: GET
+      2.3) **url**: api/v1/image/get-image/[**name**]
+            2.3.1) **name**: *the name of the AI instance.*
+      1.4) **returns**: Image - **content-type**: image/[mime]
+
+```seq
+Config(nodeWidth: 280, nodeMessageHeight: 17, nodeEventHeight: 10, nodeCommentHeight: 26, widthBias: 60, heightBias: 30, lineNumbers: false, border: true, backgroundColor: #EAFEEA)
+
+Nodes[Browser, ActorDemo, ImageService]
+ActorDemo -o ImageService[http]: 
+Browser browser [puppeteer]: srcActorDemo
+Browser page [puppeteer]: page1
+Browser -o ActorDemo[http]: 
+Browser => ActorDemo[http]: GET http://localhost:9045/start
+ActorDemo => Browser[http]: 200 OK
+Browser /**/ ActorDemo[http]: Loading site (js, css, images, REST API, ... .)
+Browser click [puppeteer]: id = #from_start_to_image_ai
+Browser => ActorDemo[http]: POST http://actordemo:9045/abs-data/AiGetImages
+ActorDemo => ImageService[http]: GET api/v1/image/get-images
+ImageService => ActorDemo[http]: 200 OK
+ActorDemo => Browser[http]: 200 OK
+Browser => ActorDemo[http]: POST http://actordemo:9045/abs-data/AiGetImage
+ActorDemo => ImageService[http]: GET api/v1/image/get-image/Justin
+ImageService => ActorDemo[http]: 200 OK
+ActorDemo => Browser[http]: 200 OK
+ImageService -x ActorDemo[http]: 
+Browser -x ActorDemo[http]: 
+```
+
+---
+#### **Conclusion**
+1) Create an [[REF=, ABS_Originating_Actor]] with the [[REF=, STACK_PUPPETEER]] stack.
+  1.1 **Click** the button with ***selector***: #from_start_to_image_ai
+2) Create a [[REF=, ABS_Terminating_Actor]] with the [[REF=, STACK_HTTP]] stack.
+  2.1 Answer the [[REF=, STACK_HTTP]] REST API ***request*** AiGetImages. Answer with one image: [{name:'Justin',mime:'images/jpeg',ais:['background', 'shirt', 'sunglasses']}]
+  2.2 Answer the [[REF=, STACK_HTTP]] REST API ***request*** AiGetImage/Justin. Answer with the image requested.
+
+---
+#### **Solution**
++ Test Case: [GotoImageAI](/../test-cases/ActorDemo/ImageIA/GotoImageAI)