# d-navio-project/d-navio-platform architecture

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

- Interactive diagram: https://gitdiagram.com/d-navio-project/d-navio-platform
- Repository: https://github.com/d-navio-project/d-navio-platform

## Overview

D-NAVIO is a bootstrap platform for digital-twin services: Kafka carries asynchronous events, Keycloak supplies identity, and MinIO stores datasets and binary artefacts. The main interaction shown in source is a partner client obtaining a Keycloak token, then sending telemetry to or reading messages from Kafka; internal platform consumers use Kafka for live events. Helm paths identify the deployment subsystems, but their templates were not sampled, so configuration-level links are limited to README-documented roles. The repository also includes a local test producer and a partner mock.

Main entry points: [`helm/dnavio-platform/templates/kafka`](https://github.com/d-navio-project/d-navio-platform/tree/main/helm/dnavio-platform/templates/kafka) (Kafka broker), [`apps/partner-mock/main.py`](https://github.com/d-navio-project/d-navio-platform/blob/main/apps/partner-mock/main.py) (Partner mock API), [`helm/dnavio-platform/templates/keycloak`](https://github.com/d-navio-project/d-navio-platform/tree/main/helm/dnavio-platform/templates/keycloak) (Keycloak), [`apps/test-producer/main.py`](https://github.com/d-navio-project/d-navio-platform/blob/main/apps/test-producer/main.py) (Test producer API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_messaging["Event backbone"]
  node_kafka["Kafka broker"]
  node_kafka_topics["Topic bootstrap<br/>[topics-job.yaml]"]
  node_kafka_acls["Kafka ACLs<br/>[acls-job.yaml]"]
end

subgraph group_identity["Identity service"]
  node_keycloak["Keycloak"]
  node_keycloak_bootstrap["Identity bootstrap<br/>[bootstrap-job.yaml]"]
end

subgraph group_storage["Object storage"]
  node_minio[("MinIO object store")]
end

subgraph group_clients["Integration clients"]
  node_partner_mock["Partner mock API<br/>[main.py]"]
  node_test_producer["Test producer API<br/>[main.py]"]
end

node_partner(("External partner"))
node_platform_consumers(("Platform consumers"))

node_partner -->|"calls API"| node_partner_mock
node_partner_mock -->|"requests token"| node_keycloak
node_partner_mock -->|"produces messages"| node_kafka
node_partner_mock -->|"consumes messages"| node_kafka
node_test_producer -->|"requests token"| node_keycloak
node_test_producer -->|"produces messages"| node_kafka
node_test_producer -->|"consumes messages"| node_kafka
node_platform_consumers -->|"exchange events"| node_kafka
node_kafka_topics -.->|"initializes topics"| node_kafka
node_kafka_acls -.->|"configures access"| node_kafka
node_keycloak_bootstrap -.->|"bootstraps identity"| node_keycloak
node_partner_mock -->|"validates token access"| node_keycloak

click node_kafka "https://github.com/d-navio-project/d-navio-platform/tree/main/helm/dnavio-platform/templates/kafka"
click node_kafka_topics "https://github.com/d-navio-project/d-navio-platform/blob/main/helm/dnavio-platform/templates/kafka/topics-job.yaml"
click node_kafka_acls "https://github.com/d-navio-project/d-navio-platform/blob/main/helm/dnavio-platform/templates/kafka/acls-job.yaml"
click node_keycloak "https://github.com/d-navio-project/d-navio-platform/tree/main/helm/dnavio-platform/templates/keycloak"
click node_keycloak_bootstrap "https://github.com/d-navio-project/d-navio-platform/blob/main/helm/dnavio-platform/templates/keycloak/bootstrap-job.yaml"
click node_minio "https://github.com/d-navio-project/d-navio-platform/tree/main/helm/dnavio-platform/templates/minio"
click node_partner_mock "https://github.com/d-navio-project/d-navio-platform/blob/main/apps/partner-mock/main.py"
click node_test_producer "https://github.com/d-navio-project/d-navio-platform/blob/main/apps/test-producer/main.py"

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_kafka,node_kafka_topics,node_kafka_acls toneBlue
class node_keycloak,node_keycloak_bootstrap toneAmber
class node_minio toneMint
class node_partner_mock,node_test_producer toneRose
class node_partner,node_platform_consumers toneIndigo
```

## Components

### Event backbone

- [Kafka broker](https://github.com/d-navio-project/d-navio-platform/tree/main/helm/dnavio-platform/templates/kafka): `helm/dnavio-platform/templates/kafka`
- [Topic bootstrap](https://github.com/d-navio-project/d-navio-platform/blob/main/helm/dnavio-platform/templates/kafka/topics-job.yaml): `helm/dnavio-platform/templates/kafka/topics-job.yaml`
- [Kafka ACLs](https://github.com/d-navio-project/d-navio-platform/blob/main/helm/dnavio-platform/templates/kafka/acls-job.yaml): `helm/dnavio-platform/templates/kafka/acls-job.yaml`

### Identity service

- [Keycloak](https://github.com/d-navio-project/d-navio-platform/tree/main/helm/dnavio-platform/templates/keycloak): `helm/dnavio-platform/templates/keycloak`
- [Identity bootstrap](https://github.com/d-navio-project/d-navio-platform/blob/main/helm/dnavio-platform/templates/keycloak/bootstrap-job.yaml): `helm/dnavio-platform/templates/keycloak/bootstrap-job.yaml`

### Object storage

- [MinIO object store](https://github.com/d-navio-project/d-navio-platform/tree/main/helm/dnavio-platform/templates/minio): `helm/dnavio-platform/templates/minio`

### Integration clients

- [Partner mock API](https://github.com/d-navio-project/d-navio-platform/blob/main/apps/partner-mock/main.py): `apps/partner-mock/main.py`
- [Test producer API](https://github.com/d-navio-project/d-navio-platform/blob/main/apps/test-producer/main.py): `apps/test-producer/main.py`

### Other components

- **External partner**
- **Platform consumers**

## Connections

- External partner → Partner mock API: calls API (evidence: `apps/partner-mock/main.py`)
- Partner mock API → Keycloak: requests token (evidence: `apps/partner-mock/main.py`)
- Partner mock API → Kafka broker: produces messages (evidence: `apps/partner-mock/main.py`)
- Partner mock API → Kafka broker: consumes messages (evidence: `apps/partner-mock/main.py`)
- Test producer API → Keycloak: requests token (evidence: `apps/test-producer/main.py`)
- Test producer API → Kafka broker: produces messages (evidence: `apps/test-producer/main.py`)
- Test producer API → Kafka broker: consumes messages (evidence: `apps/test-producer/main.py`)
- Platform consumers → Kafka broker: exchange events (evidence: `README.md`)
- Topic bootstrap → Kafka broker: initializes topics
- Kafka ACLs → Kafka broker: configures access
- Identity bootstrap → Keycloak: bootstraps identity
- Partner mock API → Keycloak: validates token access (evidence: `apps/partner-mock/main.py`)
