add architecture part 1

Author: skadefro

docs/README.md

@@ -7,6 +7,8 @@ For production environment we recommend moving to kubernetes
 
 Read more about the [security model here](securitymodel).
 
+Read more about the [architecture here](architecture).
+
 #### Quick start using docker
 Installing using [docker-compose](dockercompose)
 

docs/architecture.md

@@ -0,0 +1,19 @@
+## Architecture
+
+OpenFlow is an extendible stack, it's core components consist of a [MongoDB](https://www.mongodb.com/) database (preferably a replica set to allow support for change streams )
+A stateless [RabbitMQ](https://www.rabbitmq.com/) (but if needed you can run with durable queues and persistent storage)
+And the OpenFlow API and web interface.
+If deployed in docker, you can the spin up multiple NodeRED instances using the API or from the we interface.
+Different types of clients, [custom web](https://github.com/open-rpa/openflow-web-angular11-template) interfaces, [OpenRPA](https://github.com/open-rpa/openrpa) robots, PowerShell modules and remotely installed NodeRED's can then connect to the OpenFlow API using web sockets and receive events and data. Clients will use the API to register/publish queues and exchanges in order to add an extra layer of authentication and to simply for network requirements. All database access is exposed as natively close to the MongoDB driver, but with an added layer of security though the API
+
+If installed [using NPM](https://openflow.openiap.io/npmopenflow) or the basic [docker-compose](https://github.com/open-rpa/openflow/blob/master/docker-compose.yml) file that would like something like this
+
+![openflow_basic](architecture/openflow_basic.png)
+
+But for most people you should go for the docker install using [traefik](https://traefik.io/) as an ingress controller/reverse proxy. This way we can segregate internal traffic that only OpenFlow should know about from traffic going in and out to the rest of the network/world. That will look something like below
+
+![openflow_traefik](architecture/openflow_with_traefik.png)
+
+For bigger installations we recommend using kubernetes. Besides adding easy access for running geo distributed installation ( multiple data centers ) it also adds more layers of security and much needed fault tolerance and scalability. This is usually also when we want to add better monitoring of the core components and support for designing graphs and dashboard based on data in OpenFlow.
+
+![openflow_with_otel](architecture/openflow_with_monitoring.png)

docs/architecture/.gitignore

@@ -0,0 +1 @@
+__pycache__

docs/architecture/diagram.py

@@ -0,0 +1,87 @@
+from diagrams import Cluster, Diagram
+from diagrams.aws.compute import ECS, EC2
+from diagrams.onprem.database import Mongodb
+from diagrams.onprem.queue import Rabbitmq
+from diagrams.gcp.analytics import BigQuery, Dataflow, PubSub
+from diagrams.programming.language import Nodejs
+from diagrams.onprem.monitoring import Grafana, Prometheus
+from diagrams.aws.database import RDS
+from diagrams.aws.network import ELB
+from diagrams.aws.storage import S3
+from diagrams.onprem.network import Traefik
+from diagrams.custom import Custom
+from diagrams.onprem.tracing import Jaeger
+from diagrams.onprem.database import Cassandra
+
+with Diagram("OpenFlow Basic"):
+    with Cluster("Backend"):
+        b = [Mongodb("MongoDB"), Rabbitmq("RabbitMQ")]
+    with Cluster("Remote Clients"):
+        rc = [Custom("OpenRPA", "./my_resources/open_rpa128.png"), Custom("PowerShell",
+                                                                          "./my_resources/PowerShell_5.0_icon.png"), Custom("NodeRED", "./my_resources/node-red-icon.png")]
+    with Cluster("Frontend + API"):
+        api = EC2("WEB-API")
+        Custom("NodeRED", "./my_resources/node-red-icon.png")
+    b << api
+    api << rc
+
+with Diagram("OpenFlow with Traefik"):
+
+    with Cluster("Backend"):
+        b = [Mongodb("MongoDB"), Rabbitmq("RabbitMQ")]
+
+    with Cluster("Remote Clients"):
+        rc = [Custom("OpenRPA", "./my_resources/open_rpa128.png"), Custom("PowerShell",
+                                                                          "./my_resources/PowerShell_5.0_icon.png"), Custom("NodeRED", "./my_resources/node-red-icon.png")]
+
+    with Cluster("Frontend + API"):
+        api = EC2("WEB-API")
+        cn = Custom("NodeRED", "./my_resources/node-red-icon.png")
+
+    t = Traefik("Traefik")
+
+    b << api
+    cn << t
+    api << t
+    t << rc
+
+
+with Diagram("OpenFlow with Monitoring"):
+
+    with Cluster("Backend"):
+        b = [Mongodb("MongoDB"), Rabbitmq("RabbitMQ")]
+
+    with Cluster("Remote Clients"):
+        rc = [Custom("OpenRPA", "./my_resources/open_rpa128.png"), Custom("PowerShell",
+                                                                          "./my_resources/PowerShell_5.0_icon.png"), Custom("NodeRED", "./my_resources/node-red-icon.png")]
+
+    with Cluster("Frontend + API"):
+        api = EC2("WEB-API")
+        cn = Custom("NodeRED", "./my_resources/node-red-icon.png")
+
+    with Cluster("Monitoring"):
+        g = Grafana("Grafana")
+        p = Prometheus("Prometheus")
+        otel = EC2("Open Telemetry")
+        j = Jaeger("Jaeger")
+        c = Cassandra("Cassandra")
+
+    t = Traefik("Traefik")
+
+    b << api
+    cn << t
+    api << t
+    t << rc
+
+    otel << b
+    otel << rc
+    otel << api
+    otel << cn
+
+    c << j
+    j << otel
+
+    p << otel
+    p << g
+    api << g
+    g << t