# elizaveta-andreeva/platform architecture

> Architecture diagram of the GitHub repository elizaveta-andreeva/platform, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/elizaveta-andreeva/platform
- Repository: https://github.com/elizaveta-andreeva/platform

## Overview

oktoflow is an AI-enabled Industry 4.0/IIoT platform for modeling, integrating, and running distributed industrial applications. The principal workflow is to model services, connectors, and typed data flows in the management UI or textual configuration; generate an application environment; integrate user implementations; then execute locally or distribute deployment across heterogeneous devices. The graph also preserves platform services, AAS support, storage, and connector capabilities. README-documented edges describe the overall workflow; source-level evidence is limited to the sampled service-instantiation and storage code.

Main entry points: [`platform/services/services.environment/src/main/java/de/iip_ecosphere/platform/services/environment`](https://github.com/elizaveta-andreeva/platform/tree/main/platform/services/services.environment/src/main/java/de/iip_ecosphere/platform/services/environment) (Service environment), [`platform/configuration/configuration.easy/src/main/java/de/iip_ecosphere/platform/configuration/easyProducer`](https://github.com/elizaveta-andreeva/platform/tree/main/platform/configuration/configuration.easy/src/main/java/de/iip_ecosphere/platform/configuration/easyProducer) (Easy configuration), [`platform/services/services.environment/src/main/java/de/iip_ecosphere/platform/services/environment/AbstractService.java`](https://github.com/elizaveta-andreeva/platform/blob/main/platform/services/services.environment/src/main/java/de/iip_ecosphere/platform/services/environment/AbstractService.java) (Service lifecycle), [`platform/resources/deviceMgt/src/main/java/de/iip_ecosphere/platform/deviceMgt/storage/StorageFactory.java`](https://github.com/elizaveta-andreeva/platform/blob/main/platform/resources/deviceMgt/src/main/java/de/iip_ecosphere/platform/deviceMgt/storage/StorageFactory.java) (Storage factory)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_authoring["Application authoring"]
  node_ui["Management UI"]
  node_textmodel["Text configuration"]
  node_configapi["Configuration API<br/>[cfg]"]
  node_configeasy["Easy configuration<br/>[easyProducer]"]
  node_generation["Code generation<br/>[maven]"]
end

subgraph group_runtime["Application runtime"]
  node_serviceenv["Service environment<br/>[environment]"]
  node_abstractservice["Service lifecycle"]
  node_yamlservice["YAML services<br/>[YamlService.java]"]
  node_appmanager["Service manager"]
  node_deployment["Deployment plans"]
  node_platformclient["Platform client"]
end

subgraph group_integration["Industrial integration"]
  node_connectors["Industrial connectors"]
  node_aasconnector["AAS connector<br/>[AasConnector.java]"]
  node_traceaas["Trace to AAS"]
  node_opcua["OPC UA model tools<br/>[opcua]"]
  node_rtsa["RTSA service"]
  node_kodex["KODEX service<br/>[KodexService.java]"]
end

subgraph group_platform["Platform operations"]
  node_device["Device management"]
  node_storagefactory["Storage factory"]
  node_packagestorage["Package storage"]
  node_s3["S3 storage"]
end

subgraph group_foundation["Runtime foundation"]
  node_plugins["Plugin manager<br/>[PluginManager.java]"]
  node_logger["Logging<br/>[LoggerFactory.java]"]
end

node_user(("Application developer"))
node_externaldata(("Industrial devices and data"))
node_edgehosts(("Edge devices"))

node_user -->|"models in"| node_ui
node_user -->|"edits directly"| node_textmodel
node_ui -->|"creates models"| node_configeasy
node_textmodel -.->|"defines configuration"| node_configapi
node_configeasy -.->|"implements configuration"| node_configapi
node_configapi -.->|"configures generation"| node_generation
node_generation -->|"generates environment"| node_serviceenv
node_serviceenv -.->|"hosts services"| node_abstractservice
node_abstractservice -->|"instantiates services"| node_yamlservice
node_serviceenv -.->|"manages execution"| node_appmanager
node_appmanager -.->|"controls platform"| node_platformclient
node_platformclient -.->|"uses deployment plan"| node_deployment
node_deployment -->|"targets distributed execution"| node_edgehosts
node_serviceenv -->|"integrates data flows"| node_connectors
node_externaldata -->|"supplies industrial data"| node_connectors
node_connectors -.->|"includes AAS access"| node_aasconnector
node_traceaas -.->|"uses AAS integration"| node_aasconnector
node_configeasy -.->|"provides OPC UA tooling"| node_opcua
node_device -.->|"provides storage access"| node_storagefactory
node_storagefactory -->|"loads setup"| node_packagestorage
node_storagefactory -->|"creates storage"| node_s3
node_serviceenv -.->|"uses plugins"| node_plugins
node_abstractservice -->|"logs through"| node_logger
node_serviceenv -->|"hosts analytics service"| node_rtsa
node_serviceenv -.->|"hosts data-protection service"| node_kodex

click node_ui "https://github.com/elizaveta-andreeva/platform/tree/main/platform/managementUI"
click node_textmodel "https://github.com/elizaveta-andreeva/platform/tree/main/platform/configuration/configuration"
click node_configapi "https://github.com/elizaveta-andreeva/platform/tree/main/platform/configuration/configuration.interface/src/main/java/de/iip_ecosphere/platform/configuration/cfg"
click node_configeasy "https://github.com/elizaveta-andreeva/platform/tree/main/platform/configuration/configuration.easy/src/main/java/de/iip_ecosphere/platform/configuration/easyProducer"
click node_generation "https://github.com/elizaveta-andreeva/platform/tree/main/platform/configuration/configuration.maven/src/main/java/de/iip_ecosphere/platform/configuration/maven"
click node_serviceenv "https://github.com/elizaveta-andreeva/platform/tree/main/platform/services/services.environment/src/main/java/de/iip_ecosphere/platform/services/environment"
click node_abstractservice "https://github.com/elizaveta-andreeva/platform/blob/main/platform/services/services.environment/src/main/java/de/iip_ecosphere/platform/services/environment/AbstractService.java"
click node_yamlservice "https://github.com/elizaveta-andreeva/platform/blob/main/platform/services/services.spring/src/main/java/de/iip_ecosphere/platform/services/spring/yaml/YamlService.java"
click node_appmanager "https://github.com/elizaveta-andreeva/platform/blob/main/platform/services/services/src/main/java/de/iip_ecosphere/platform/services/AbstractServiceManager.java"
click node_deployment "https://github.com/elizaveta-andreeva/platform/blob/main/platform/platform/src/main/java/de/iip_ecosphere/platform/platform/cli/ServiceDeploymentPlan.java"
click node_platformclient "https://github.com/elizaveta-andreeva/platform/blob/main/platform/platform/src/main/java/de/iip_ecosphere/platform/platform/cli/PlatformClientFactory.java"
click node_connectors "https://github.com/elizaveta-andreeva/platform/tree/main/platform/connectors"
click node_aasconnector "https://github.com/elizaveta-andreeva/platform/blob/main/platform/connectors/connectors.basyx/src/main/java/de/iip_ecosphere/platform/connectors/aas/AasConnector.java"
click node_traceaas "https://github.com/elizaveta-andreeva/platform/blob/main/platform/services/services.environment/src/main/java/de/iip_ecosphere/platform/services/environment/services/TraceToAasService.java"
click node_opcua "https://github.com/elizaveta-andreeva/platform/tree/main/platform/configuration/configuration.easy/src/main/java/de/iip_ecosphere/platform/configuration/easyProducer/opcua"
click node_device "https://github.com/elizaveta-andreeva/platform/tree/main/platform/resources/deviceMgt/src/main/java/de/iip_ecosphere/platform/deviceMgt/storage"
click node_storagefactory "https://github.com/elizaveta-andreeva/platform/blob/main/platform/resources/deviceMgt/src/main/java/de/iip_ecosphere/platform/deviceMgt/storage/StorageFactory.java"
click node_packagestorage "https://github.com/elizaveta-andreeva/platform/blob/main/platform/resources/deviceMgt/src/main/java/de/iip_ecosphere/platform/deviceMgt/storage/PackageStorageSetup.java"
click node_s3 "https://github.com/elizaveta-andreeva/platform/blob/main/platform/resources/deviceMgt.minio/src/main/java/de/iip_ecosphere/platform/deviceMgt/minio/S3StorageFactoryDescriptor.java"
click node_plugins "https://github.com/elizaveta-andreeva/platform/blob/main/platform/support/support.boot/src/main/java/de/iip_ecosphere/platform/support/plugins/PluginManager.java"
click node_logger "https://github.com/elizaveta-andreeva/platform/blob/main/platform/support/support.boot/src/main/java/de/iip_ecosphere/platform/support/logging/LoggerFactory.java"
click node_rtsa "https://github.com/elizaveta-andreeva/platform/blob/main/platform/reusableIntelligentServices/kiServices.rapidminer.rtsa/src/main/java/de/iip_ecosphere/platform/kiServices/rapidminer/rtsa/RtsaRestService.java"
click node_kodex "https://github.com/elizaveta-andreeva/platform/blob/main/platform/securityDataProtection/security.services.kodex/src/main/java/de/iip_ecosphere/platform/security/services/kodex/KodexService.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_ui,node_textmodel,node_configapi,node_configeasy,node_generation toneBlue
class node_serviceenv,node_abstractservice,node_yamlservice,node_appmanager,node_deployment,node_platformclient toneAmber
class node_connectors,node_aasconnector,node_traceaas,node_opcua,node_rtsa,node_kodex toneMint
class node_device,node_storagefactory,node_packagestorage,node_s3 toneRose
class node_plugins,node_logger,node_user,node_externaldata,node_edgehosts toneIndigo
```

## Components

### Application authoring

- [Management UI](https://github.com/elizaveta-andreeva/platform/tree/main/platform/managementUI): `platform/managementUI`
- [Text configuration](https://github.com/elizaveta-andreeva/platform/tree/main/platform/configuration/configuration): `platform/configuration/configuration`
- [Configuration API](https://github.com/elizaveta-andreeva/platform/tree/main/platform/configuration/configuration.interface/src/main/java/de/iip_ecosphere/platform/configuration/cfg): `platform/configuration/configuration.interface/src/main/java/de/iip_ecosphere/platform/configuration/cfg`
- [Easy configuration](https://github.com/elizaveta-andreeva/platform/tree/main/platform/configuration/configuration.easy/src/main/java/de/iip_ecosphere/platform/configuration/easyProducer): `platform/configuration/configuration.easy/src/main/java/de/iip_ecosphere/platform/configuration/easyProducer`
- [Code generation](https://github.com/elizaveta-andreeva/platform/tree/main/platform/configuration/configuration.maven/src/main/java/de/iip_ecosphere/platform/configuration/maven): `platform/configuration/configuration.maven/src/main/java/de/iip_ecosphere/platform/configuration/maven`

### Application runtime

- [Service environment](https://github.com/elizaveta-andreeva/platform/tree/main/platform/services/services.environment/src/main/java/de/iip_ecosphere/platform/services/environment): `platform/services/services.environment/src/main/java/de/iip_ecosphere/platform/services/environment`
- [Service lifecycle](https://github.com/elizaveta-andreeva/platform/blob/main/platform/services/services.environment/src/main/java/de/iip_ecosphere/platform/services/environment/AbstractService.java): `platform/services/services.environment/src/main/java/de/iip_ecosphere/platform/services/environment/AbstractService.java`
- [YAML services](https://github.com/elizaveta-andreeva/platform/blob/main/platform/services/services.spring/src/main/java/de/iip_ecosphere/platform/services/spring/yaml/YamlService.java): `platform/services/services.spring/src/main/java/de/iip_ecosphere/platform/services/spring/yaml/YamlService.java`
- [Service manager](https://github.com/elizaveta-andreeva/platform/blob/main/platform/services/services/src/main/java/de/iip_ecosphere/platform/services/AbstractServiceManager.java): `platform/services/services/src/main/java/de/iip_ecosphere/platform/services/AbstractServiceManager.java`
- [Deployment plans](https://github.com/elizaveta-andreeva/platform/blob/main/platform/platform/src/main/java/de/iip_ecosphere/platform/platform/cli/ServiceDeploymentPlan.java): `platform/platform/src/main/java/de/iip_ecosphere/platform/platform/cli/ServiceDeploymentPlan.java`
- [Platform client](https://github.com/elizaveta-andreeva/platform/blob/main/platform/platform/src/main/java/de/iip_ecosphere/platform/platform/cli/PlatformClientFactory.java): `platform/platform/src/main/java/de/iip_ecosphere/platform/platform/cli/PlatformClientFactory.java`

### Industrial integration

- [Industrial connectors](https://github.com/elizaveta-andreeva/platform/tree/main/platform/connectors): `platform/connectors`
- [AAS connector](https://github.com/elizaveta-andreeva/platform/blob/main/platform/connectors/connectors.basyx/src/main/java/de/iip_ecosphere/platform/connectors/aas/AasConnector.java): `platform/connectors/connectors.basyx/src/main/java/de/iip_ecosphere/platform/connectors/aas/AasConnector.java`
- [Trace to AAS](https://github.com/elizaveta-andreeva/platform/blob/main/platform/services/services.environment/src/main/java/de/iip_ecosphere/platform/services/environment/services/TraceToAasService.java): `platform/services/services.environment/src/main/java/de/iip_ecosphere/platform/services/environment/services/TraceToAasService.java`
- [OPC UA model tools](https://github.com/elizaveta-andreeva/platform/tree/main/platform/configuration/configuration.easy/src/main/java/de/iip_ecosphere/platform/configuration/easyProducer/opcua): `platform/configuration/configuration.easy/src/main/java/de/iip_ecosphere/platform/configuration/easyProducer/opcua`
- [RTSA service](https://github.com/elizaveta-andreeva/platform/blob/main/platform/reusableIntelligentServices/kiServices.rapidminer.rtsa/src/main/java/de/iip_ecosphere/platform/kiServices/rapidminer/rtsa/RtsaRestService.java): `platform/reusableIntelligentServices/kiServices.rapidminer.rtsa/src/main/java/de/iip_ecosphere/platform/kiServices/rapidminer/rtsa/RtsaRestService.java`
- [KODEX service](https://github.com/elizaveta-andreeva/platform/blob/main/platform/securityDataProtection/security.services.kodex/src/main/java/de/iip_ecosphere/platform/security/services/kodex/KodexService.java): `platform/securityDataProtection/security.services.kodex/src/main/java/de/iip_ecosphere/platform/security/services/kodex/KodexService.java`

### Platform operations

- [Device management](https://github.com/elizaveta-andreeva/platform/tree/main/platform/resources/deviceMgt/src/main/java/de/iip_ecosphere/platform/deviceMgt/storage): `platform/resources/deviceMgt/src/main/java/de/iip_ecosphere/platform/deviceMgt/storage`
- [Storage factory](https://github.com/elizaveta-andreeva/platform/blob/main/platform/resources/deviceMgt/src/main/java/de/iip_ecosphere/platform/deviceMgt/storage/StorageFactory.java): `platform/resources/deviceMgt/src/main/java/de/iip_ecosphere/platform/deviceMgt/storage/StorageFactory.java`
- [Package storage](https://github.com/elizaveta-andreeva/platform/blob/main/platform/resources/deviceMgt/src/main/java/de/iip_ecosphere/platform/deviceMgt/storage/PackageStorageSetup.java): `platform/resources/deviceMgt/src/main/java/de/iip_ecosphere/platform/deviceMgt/storage/PackageStorageSetup.java`
- [S3 storage](https://github.com/elizaveta-andreeva/platform/blob/main/platform/resources/deviceMgt.minio/src/main/java/de/iip_ecosphere/platform/deviceMgt/minio/S3StorageFactoryDescriptor.java): `platform/resources/deviceMgt.minio/src/main/java/de/iip_ecosphere/platform/deviceMgt/minio/S3StorageFactoryDescriptor.java`

### Runtime foundation

- [Plugin manager](https://github.com/elizaveta-andreeva/platform/blob/main/platform/support/support.boot/src/main/java/de/iip_ecosphere/platform/support/plugins/PluginManager.java): `platform/support/support.boot/src/main/java/de/iip_ecosphere/platform/support/plugins/PluginManager.java`
- [Logging](https://github.com/elizaveta-andreeva/platform/blob/main/platform/support/support.boot/src/main/java/de/iip_ecosphere/platform/support/logging/LoggerFactory.java): `platform/support/support.boot/src/main/java/de/iip_ecosphere/platform/support/logging/LoggerFactory.java`

### Other components

- **Application developer**
- **Industrial devices and data**
- **Edge devices**

## Connections

- Application developer → Management UI: models in (evidence: `README.md`)
- Application developer → Text configuration: edits directly (evidence: `README.md`)
- Management UI → Easy configuration: creates models (evidence: `README.md`)
- Text configuration → Configuration API: defines configuration (evidence: `platform/configuration/configuration/src/main/java/de/iip_ecosphere/platform/configuration/StorageFactory.java`)
- Easy configuration → Configuration API: implements configuration
- Configuration API → Code generation: configures generation
- Code generation → Service environment: generates environment (evidence: `README.md`)
- Service environment → Service lifecycle: hosts services (evidence: `platform/services/services.environment/src/main/java/de/iip_ecosphere/platform/services/environment/services/TraceToAasService.java`)
- Service lifecycle → YAML services: instantiates services (evidence: `platform/services/services.environment/src/main/java/de/iip_ecosphere/platform/services/environment/AbstractService.java`)
- Service environment → Service manager: manages execution
- Service manager → Platform client: controls platform
- Platform client → Deployment plans: uses deployment plan
- Deployment plans → Edge devices: targets distributed execution (evidence: `README.md`)
- Service environment → Industrial connectors: integrates data flows (evidence: `README.md`)
- Industrial devices and data → Industrial connectors: supplies industrial data (evidence: `README.md`)
- Industrial connectors → AAS connector: includes AAS access
- Trace to AAS → AAS connector: uses AAS integration
- Easy configuration → OPC UA model tools: provides OPC UA tooling
- Device management → Storage factory: provides storage access (evidence: `platform/resources/deviceMgt/src/main/java/de/iip_ecosphere/platform/deviceMgt/storage/StorageFactory.java`)
- Storage factory → Package storage: loads setup (evidence: `platform/resources/deviceMgt/src/main/java/de/iip_ecosphere/platform/deviceMgt/storage/StorageFactory.java`)
- Storage factory → S3 storage: creates storage (evidence: `platform/resources/deviceMgt.minio/src/main/java/de/iip_ecosphere/platform/deviceMgt/minio/S3StorageFactoryDescriptor.java`)
- Service environment → Plugin manager: uses plugins (evidence: `platform/services/services.environment/src/main/java/de/iip_ecosphere/platform/services/environment/AbstractService.java`)
- Service lifecycle → Logging: logs through (evidence: `platform/services/services.environment/src/main/java/de/iip_ecosphere/platform/services/environment/AbstractService.java`)
- Service environment → RTSA service: hosts analytics service (evidence: `README.md`)
- Service environment → KODEX service: hosts data-protection service (evidence: `platform/securityDataProtection/security.services.kodex/src/main/java/de/iip_ecosphere/platform/security/services/kodex/KodexService.java`)
