# astrikosai/adp_frontend architecture

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

- Interactive diagram: https://gitdiagram.com/astrikosai/adp_frontend
- Repository: https://github.com/astrikosai/adp_frontend

## Overview

This repository is a React/TypeScript operations platform with modules for data exchange, asset and relationship management, workflow execution, model work, KPIs, and operational insights. A user enters the application and works through these distinct capabilities; the tree also shows platform administration and onboarding. The sampled source supports a few internal call relationships, but does not expose the full route wiring or most module-to-service interactions, so those links are left out rather than inferred.

Main entry points: [`src/modules/advanced-iot/components/AdvancedIoTEngine.tsx`](https://github.com/astrikosai/adp_frontend/blob/master/src/modules/advanced-iot/components/AdvancedIoTEngine.tsx) (Advanced IoT engine), [`src/modules/agentic-workbench/hooks/useWorkbenchSession.ts`](https://github.com/astrikosai/adp_frontend/blob/master/src/modules/agentic-workbench/hooks/useWorkbenchSession.ts) (Session state), [`src/modules/library/components/RelationshipManager.tsx`](https://github.com/astrikosai/adp_frontend/blob/master/src/modules/library/components/RelationshipManager.tsx) (Relationship manager), [`src/modules/agentic-workbench/components/pipeline/PipelinePanel.tsx`](https://github.com/astrikosai/adp_frontend/blob/master/src/modules/agentic-workbench/components/pipeline/PipelinePanel.tsx) (Pipeline panel)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application shell"]
  node_app["Application<br/>[App.tsx]"]
  node_auth["Authentication<br/>[AuthContext.tsx]"]
  node_onboarding["Onboarding wizard"]
end

subgraph group_data["Data and assets"]
  node_exchange["Data exchange"]
  node_datagrid["Data grid"]
  node_library["Asset library"]
  node_relationships["Relationship manager"]
  node_relationship_graph["Relationship graph"]
  node_konnekt["Connectors"]
end

subgraph group_workflow["Workflow and models"]
  node_flow["Flow builder"]
  node_execution["Flow execution"]
  node_workbench["Agent workbench"]
  node_session_hook["Session state"]
  node_pipeline_panel["Pipeline panel<br/>[PipelinePanel.tsx]"]
end

subgraph group_insight["Insights and KPIs"]
  node_insights["Insight builder"]
  node_engine_runs["Engine runs<br/>[EngineRunsPage.tsx]"]
  node_kpi["KPI management"]
end

subgraph group_platform["Platform administration"]
  node_platform_manager["Platform manager"]
  node_services_manager["Services manager"]
  node_master_config["Master configuration"]
  node_advanced_iot["Advanced IoT engine"]
  node_master_config_service["Configuration service"]
end

node_user(("Platform user"))
node_iot_service["External IoT engine"]
node_insight_service["Insight API service"]
node_workbench_service["Workbench service"]

node_user -->|"uses"| node_app
node_relationships -->|"renders"| node_relationship_graph
node_engine_runs -->|"loads runs"| node_insight_service
node_session_hook -->|"loads session"| node_workbench_service
node_pipeline_panel -->|"displays state"| node_session_hook
node_advanced_iot -->|"reads config"| node_master_config_service
node_advanced_iot -.->|"embeds"| node_iot_service

click node_app "https://github.com/astrikosai/adp_frontend/blob/master/src/App.tsx"
click node_auth "https://github.com/astrikosai/adp_frontend/blob/master/src/core/auth/AuthContext.tsx"
click node_onboarding "https://github.com/astrikosai/adp_frontend/tree/master/src/core/onboarding"
click node_exchange "https://github.com/astrikosai/adp_frontend/tree/master/src/modules/data-exchange"
click node_datagrid "https://github.com/astrikosai/adp_frontend/tree/master/src/modules/datagrid"
click node_library "https://github.com/astrikosai/adp_frontend/tree/master/src/modules/library"
click node_relationships "https://github.com/astrikosai/adp_frontend/blob/master/src/modules/library/components/RelationshipManager.tsx"
click node_relationship_graph "https://github.com/astrikosai/adp_frontend/blob/master/src/modules/library/components/graph/RelationshipGraphFlow.tsx"
click node_konnekt "https://github.com/astrikosai/adp_frontend/tree/master/src/modules/konnekt"
click node_flow "https://github.com/astrikosai/adp_frontend/tree/master/src/modules/flow"
click node_execution "https://github.com/astrikosai/adp_frontend/tree/master/src/modules/execution"
click node_workbench "https://github.com/astrikosai/adp_frontend/tree/master/src/modules/agentic-workbench"
click node_session_hook "https://github.com/astrikosai/adp_frontend/blob/master/src/modules/agentic-workbench/hooks/useWorkbenchSession.ts"
click node_pipeline_panel "https://github.com/astrikosai/adp_frontend/blob/master/src/modules/agentic-workbench/components/pipeline/PipelinePanel.tsx"
click node_insights "https://github.com/astrikosai/adp_frontend/tree/master/src/modules/insight-builder"
click node_engine_runs "https://github.com/astrikosai/adp_frontend/blob/master/src/modules/insight-builder/components/EngineRunsPage.tsx"
click node_kpi "https://github.com/astrikosai/adp_frontend/tree/master/src/modules/kpi"
click node_platform_manager "https://github.com/astrikosai/adp_frontend/blob/master/src/core/platform/PlatformManager.tsx"
click node_services_manager "https://github.com/astrikosai/adp_frontend/blob/master/src/core/platform/PlatformServicesManager.tsx"
click node_master_config "https://github.com/astrikosai/adp_frontend/blob/master/src/core/platform/MasterConfiguration.tsx"
click node_advanced_iot "https://github.com/astrikosai/adp_frontend/blob/master/src/modules/advanced-iot/components/AdvancedIoTEngine.tsx"
click node_master_config_service "https://github.com/astrikosai/adp_frontend/blob/master/src/core/services/masterConfig/masterConfigService.ts"

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_app,node_auth,node_onboarding,node_user toneBlue
class node_exchange,node_datagrid,node_library,node_relationships,node_relationship_graph,node_konnekt toneAmber
class node_flow,node_execution,node_workbench,node_session_hook,node_pipeline_panel,node_insight_service toneMint
class node_insights,node_engine_runs,node_kpi toneRose
class node_platform_manager,node_services_manager,node_master_config,node_advanced_iot,node_master_config_service,node_iot_service,node_workbench_service toneIndigo
```

## Components

### Application shell

- [Application](https://github.com/astrikosai/adp_frontend/blob/master/src/App.tsx): `src/App.tsx`
- [Authentication](https://github.com/astrikosai/adp_frontend/blob/master/src/core/auth/AuthContext.tsx): `src/core/auth/AuthContext.tsx`
- [Onboarding wizard](https://github.com/astrikosai/adp_frontend/tree/master/src/core/onboarding): `src/core/onboarding`

### Data and assets

- [Data exchange](https://github.com/astrikosai/adp_frontend/tree/master/src/modules/data-exchange): `src/modules/data-exchange`
- [Data grid](https://github.com/astrikosai/adp_frontend/tree/master/src/modules/datagrid): `src/modules/datagrid`
- [Asset library](https://github.com/astrikosai/adp_frontend/tree/master/src/modules/library): `src/modules/library`
- [Relationship manager](https://github.com/astrikosai/adp_frontend/blob/master/src/modules/library/components/RelationshipManager.tsx): `src/modules/library/components/RelationshipManager.tsx`
- [Relationship graph](https://github.com/astrikosai/adp_frontend/blob/master/src/modules/library/components/graph/RelationshipGraphFlow.tsx): `src/modules/library/components/graph/RelationshipGraphFlow.tsx`
- [Connectors](https://github.com/astrikosai/adp_frontend/tree/master/src/modules/konnekt): `src/modules/konnekt`

### Workflow and models

- [Flow builder](https://github.com/astrikosai/adp_frontend/tree/master/src/modules/flow): `src/modules/flow`
- [Flow execution](https://github.com/astrikosai/adp_frontend/tree/master/src/modules/execution): `src/modules/execution`
- [Agent workbench](https://github.com/astrikosai/adp_frontend/tree/master/src/modules/agentic-workbench): `src/modules/agentic-workbench`
- [Session state](https://github.com/astrikosai/adp_frontend/blob/master/src/modules/agentic-workbench/hooks/useWorkbenchSession.ts): `src/modules/agentic-workbench/hooks/useWorkbenchSession.ts`
- [Pipeline panel](https://github.com/astrikosai/adp_frontend/blob/master/src/modules/agentic-workbench/components/pipeline/PipelinePanel.tsx): `src/modules/agentic-workbench/components/pipeline/PipelinePanel.tsx`

### Insights and KPIs

- [Insight builder](https://github.com/astrikosai/adp_frontend/tree/master/src/modules/insight-builder): `src/modules/insight-builder`
- [Engine runs](https://github.com/astrikosai/adp_frontend/blob/master/src/modules/insight-builder/components/EngineRunsPage.tsx): `src/modules/insight-builder/components/EngineRunsPage.tsx`
- [KPI management](https://github.com/astrikosai/adp_frontend/tree/master/src/modules/kpi): `src/modules/kpi`

### Platform administration

- [Platform manager](https://github.com/astrikosai/adp_frontend/blob/master/src/core/platform/PlatformManager.tsx): `src/core/platform/PlatformManager.tsx`
- [Services manager](https://github.com/astrikosai/adp_frontend/blob/master/src/core/platform/PlatformServicesManager.tsx): `src/core/platform/PlatformServicesManager.tsx`
- [Master configuration](https://github.com/astrikosai/adp_frontend/blob/master/src/core/platform/MasterConfiguration.tsx): `src/core/platform/MasterConfiguration.tsx`
- [Advanced IoT engine](https://github.com/astrikosai/adp_frontend/blob/master/src/modules/advanced-iot/components/AdvancedIoTEngine.tsx): `src/modules/advanced-iot/components/AdvancedIoTEngine.tsx`
- [Configuration service](https://github.com/astrikosai/adp_frontend/blob/master/src/core/services/masterConfig/masterConfigService.ts): `src/core/services/masterConfig/masterConfigService.ts`

### Other components

- **Platform user**
- **External IoT engine**
- **Insight API service**
- **Workbench service**

## Connections

- Platform user → Application: uses
- Relationship manager → Relationship graph: renders
- Engine runs → Insight API service: loads runs
- Session state → Workbench service: loads session
- Pipeline panel → Session state: displays state
- Advanced IoT engine → Configuration service: reads config
- Advanced IoT engine → External IoT engine: embeds