# abdelkderboukert/cloud-native-resilient-blueprint architecture

> Architecture diagram of the GitHub repository abdelkderboukert/cloud-native-resilient-blueprint, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/abdelkderboukert/cloud-native-resilient-blueprint
- Repository: https://github.com/abdelkderboukert/cloud-native-resilient-blueprint

## Overview

EEMP is a Kubernetes reference platform combining a Django REST API with stateful data and messaging services, edge policy, and GitOps deployment. The main user flow is HTTP through Kong to Django’s article or user APIs; article reads use Valkey, while API mutations persist through the database and publish lifecycle events to Kafka. The README documents platform services and deployment capabilities; source excerpts show API handlers, serializers, models, health checks, and event publishing. Infrastructure links rely on README descriptions and manifests, not inspected implementation details.

Main entry points: [`src/django-enterprise-api/apps/articles/views.py`](https://github.com/abdelkderboukert/cloud-native-resilient-blueprint/blob/main/src/django-enterprise-api/apps/articles/views.py) (Article API), [`src/django-enterprise-api/apps/core/kafka_producer.py`](https://github.com/abdelkderboukert/cloud-native-resilient-blueprint/blob/main/src/django-enterprise-api/apps/core/kafka_producer.py) (Kafka event publisher), [`src/django-enterprise-api/enterprise_platform/urls.py`](https://github.com/abdelkderboukert/cloud-native-resilient-blueprint/blob/main/src/django-enterprise-api/enterprise_platform/urls.py) (Django API routes), [`src/django-enterprise-api/apps/users/views.py`](https://github.com/abdelkderboukert/cloud-native-resilient-blueprint/blob/main/src/django-enterprise-api/apps/users/views.py) (User API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_edge["Edge and routing"]
  node_kong["Kong gateway"]
end

subgraph group_application["API application"]
  node_api_routes["Django API routes<br/>[urls.py]"]
  node_article_api["Article API<br/>[views.py]"]
  node_article_serializer["Article serializer<br/>[serializers.py]"]
  node_article_model["Article model<br/>[models.py]"]
  node_user_api["User API<br/>[views.py]"]
  node_user_serializer["User serializers<br/>[serializers.py]"]
  node_user_model["User profile model<br/>[models.py]"]
  node_middleware["Request correlation<br/>[middleware.py]"]
  node_health["Health and metrics<br/>[health.py]"]
end

subgraph group_data["Data services"]
  node_valkey[("Valkey cache<br/>[cache.yaml]")]
  node_postgres[("PostgreSQL cluster<br/>[cnpg-cluster.yaml]")]
  node_rustfs[("RustFS object storage<br/>[rustfs.yaml]")]
  node_longhorn[("Longhorn storage<br/>[storageclass.yaml]")]
end

subgraph group_messaging["Messaging"]
  node_event_publisher["Kafka event publisher<br/>[kafka_producer.py]"]
  node_kafka["Kafka broker<br/>[kafka.yaml]"]
end

subgraph group_platform["Platform operations"]
  node_argocd["Argo CD<br/>[application.yaml]"]
  node_helm["Helm platform chart<br/>[Chart.yaml]"]
end

node_client(("External client"))

node_client -->|"sends HTTP"| node_kong
node_kong -->|"proxies requests"| node_api_routes
node_api_routes -->|"routes articles"| node_article_api
node_api_routes -->|"routes users"| node_user_api
node_api_routes -->|"routes probes"| node_health
node_article_api -->|"serializes data"| node_article_serializer
node_article_api -->|"queries and mutates"| node_article_model
node_article_api -->|"caches reads"| node_valkey
node_article_api -->|"reads and writes"| node_postgres
node_article_api -->|"publishes lifecycle events"| node_event_publisher
node_user_api -->|"serializes users"| node_user_serializer
node_user_api -->|"queries and mutates"| node_user_model
node_user_api -->|"publishes lifecycle events"| node_event_publisher
node_event_publisher -->|"sends events"| node_kafka
node_event_publisher -->|"gets request ID"| node_middleware
node_health -->|"checks readiness"| node_postgres
node_health -->|"checks broker"| node_event_publisher
node_postgres -->|"archives WAL"| node_rustfs
node_postgres -->|"uses block storage"| node_longhorn
node_kafka -->|"uses block storage"| node_longhorn
node_rustfs -->|"uses block storage"| node_longhorn
node_argocd -->|"deploys chart"| node_helm

click node_kong "https://github.com/abdelkderboukert/cloud-native-resilient-blueprint/blob/main/deploy/helm/enterprise-platform/templates/04-edge-routing/kong-ingress-config.yaml"
click node_api_routes "https://github.com/abdelkderboukert/cloud-native-resilient-blueprint/blob/main/src/django-enterprise-api/enterprise_platform/urls.py"
click node_article_api "https://github.com/abdelkderboukert/cloud-native-resilient-blueprint/blob/main/src/django-enterprise-api/apps/articles/views.py"
click node_article_serializer "https://github.com/abdelkderboukert/cloud-native-resilient-blueprint/blob/main/src/django-enterprise-api/apps/articles/serializers.py"
click node_article_model "https://github.com/abdelkderboukert/cloud-native-resilient-blueprint/blob/main/src/django-enterprise-api/apps/articles/models.py"
click node_user_api "https://github.com/abdelkderboukert/cloud-native-resilient-blueprint/blob/main/src/django-enterprise-api/apps/users/views.py"
click node_user_serializer "https://github.com/abdelkderboukert/cloud-native-resilient-blueprint/blob/main/src/django-enterprise-api/apps/users/serializers.py"
click node_user_model "https://github.com/abdelkderboukert/cloud-native-resilient-blueprint/blob/main/src/django-enterprise-api/apps/users/models.py"
click node_middleware "https://github.com/abdelkderboukert/cloud-native-resilient-blueprint/blob/main/src/django-enterprise-api/apps/core/middleware.py"
click node_health "https://github.com/abdelkderboukert/cloud-native-resilient-blueprint/blob/main/src/django-enterprise-api/apps/core/health.py"
click node_valkey "https://github.com/abdelkderboukert/cloud-native-resilient-blueprint/blob/main/deploy/helm/enterprise-platform/templates/03-app-tier/cache.yaml"
click node_postgres "https://github.com/abdelkderboukert/cloud-native-resilient-blueprint/blob/main/deploy/helm/enterprise-platform/templates/01-data-tier/cnpg-cluster.yaml"
click node_rustfs "https://github.com/abdelkderboukert/cloud-native-resilient-blueprint/blob/main/deploy/helm/enterprise-platform/templates/01-data-tier/rustfs.yaml"
click node_longhorn "https://github.com/abdelkderboukert/cloud-native-resilient-blueprint/blob/main/deploy/helm/enterprise-platform/templates/00-infrastructure/storageclass.yaml"
click node_event_publisher "https://github.com/abdelkderboukert/cloud-native-resilient-blueprint/blob/main/src/django-enterprise-api/apps/core/kafka_producer.py"
click node_kafka "https://github.com/abdelkderboukert/cloud-native-resilient-blueprint/blob/main/deploy/helm/enterprise-platform/templates/02-messaging-tier/kafka.yaml"
click node_argocd "https://github.com/abdelkderboukert/cloud-native-resilient-blueprint/blob/main/deploy/helm/enterprise-platform/gitops/application.yaml"
click node_helm "https://github.com/abdelkderboukert/cloud-native-resilient-blueprint/blob/main/deploy/helm/enterprise-platform/Chart.yaml"

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_kong,node_client toneBlue
class node_api_routes,node_article_api,node_article_serializer,node_article_model,node_user_api,node_user_serializer,node_user_model,node_middleware,node_health toneAmber
class node_valkey,node_postgres,node_rustfs,node_longhorn toneMint
class node_event_publisher,node_kafka toneRose
class node_argocd,node_helm toneIndigo
```

## Components

### Edge and routing

- [Kong gateway](https://github.com/abdelkderboukert/cloud-native-resilient-blueprint/blob/main/deploy/helm/enterprise-platform/templates/04-edge-routing/kong-ingress-config.yaml): `deploy/helm/enterprise-platform/templates/04-edge-routing/kong-ingress-config.yaml`

### API application

- [Django API routes](https://github.com/abdelkderboukert/cloud-native-resilient-blueprint/blob/main/src/django-enterprise-api/enterprise_platform/urls.py): `src/django-enterprise-api/enterprise_platform/urls.py`
- [Article API](https://github.com/abdelkderboukert/cloud-native-resilient-blueprint/blob/main/src/django-enterprise-api/apps/articles/views.py): `src/django-enterprise-api/apps/articles/views.py`
- [Article serializer](https://github.com/abdelkderboukert/cloud-native-resilient-blueprint/blob/main/src/django-enterprise-api/apps/articles/serializers.py): `src/django-enterprise-api/apps/articles/serializers.py`
- [Article model](https://github.com/abdelkderboukert/cloud-native-resilient-blueprint/blob/main/src/django-enterprise-api/apps/articles/models.py): `src/django-enterprise-api/apps/articles/models.py`
- [User API](https://github.com/abdelkderboukert/cloud-native-resilient-blueprint/blob/main/src/django-enterprise-api/apps/users/views.py): `src/django-enterprise-api/apps/users/views.py`
- [User serializers](https://github.com/abdelkderboukert/cloud-native-resilient-blueprint/blob/main/src/django-enterprise-api/apps/users/serializers.py): `src/django-enterprise-api/apps/users/serializers.py`
- [User profile model](https://github.com/abdelkderboukert/cloud-native-resilient-blueprint/blob/main/src/django-enterprise-api/apps/users/models.py): `src/django-enterprise-api/apps/users/models.py`
- [Request correlation](https://github.com/abdelkderboukert/cloud-native-resilient-blueprint/blob/main/src/django-enterprise-api/apps/core/middleware.py): `src/django-enterprise-api/apps/core/middleware.py`
- [Health and metrics](https://github.com/abdelkderboukert/cloud-native-resilient-blueprint/blob/main/src/django-enterprise-api/apps/core/health.py): `src/django-enterprise-api/apps/core/health.py`

### Data services

- [Valkey cache](https://github.com/abdelkderboukert/cloud-native-resilient-blueprint/blob/main/deploy/helm/enterprise-platform/templates/03-app-tier/cache.yaml): `deploy/helm/enterprise-platform/templates/03-app-tier/cache.yaml`
- [PostgreSQL cluster](https://github.com/abdelkderboukert/cloud-native-resilient-blueprint/blob/main/deploy/helm/enterprise-platform/templates/01-data-tier/cnpg-cluster.yaml): `deploy/helm/enterprise-platform/templates/01-data-tier/cnpg-cluster.yaml`
- [RustFS object storage](https://github.com/abdelkderboukert/cloud-native-resilient-blueprint/blob/main/deploy/helm/enterprise-platform/templates/01-data-tier/rustfs.yaml): `deploy/helm/enterprise-platform/templates/01-data-tier/rustfs.yaml`
- [Longhorn storage](https://github.com/abdelkderboukert/cloud-native-resilient-blueprint/blob/main/deploy/helm/enterprise-platform/templates/00-infrastructure/storageclass.yaml): `deploy/helm/enterprise-platform/templates/00-infrastructure/storageclass.yaml`

### Messaging

- [Kafka event publisher](https://github.com/abdelkderboukert/cloud-native-resilient-blueprint/blob/main/src/django-enterprise-api/apps/core/kafka_producer.py): `src/django-enterprise-api/apps/core/kafka_producer.py`
- [Kafka broker](https://github.com/abdelkderboukert/cloud-native-resilient-blueprint/blob/main/deploy/helm/enterprise-platform/templates/02-messaging-tier/kafka.yaml): `deploy/helm/enterprise-platform/templates/02-messaging-tier/kafka.yaml`

### Platform operations

- [Argo CD](https://github.com/abdelkderboukert/cloud-native-resilient-blueprint/blob/main/deploy/helm/enterprise-platform/gitops/application.yaml): `deploy/helm/enterprise-platform/gitops/application.yaml`
- [Helm platform chart](https://github.com/abdelkderboukert/cloud-native-resilient-blueprint/blob/main/deploy/helm/enterprise-platform/Chart.yaml): `deploy/helm/enterprise-platform/Chart.yaml`

### Other components

- **External client**

## Connections

- External client → Kong gateway: sends HTTP (evidence: `README.md`)
- Kong gateway → Django API routes: proxies requests (evidence: `README.md`)
- Django API routes → Article API: routes articles (evidence: `src/django-enterprise-api/enterprise_platform/urls.py`)
- Django API routes → User API: routes users (evidence: `src/django-enterprise-api/enterprise_platform/urls.py`)
- Django API routes → Health and metrics: routes probes (evidence: `src/django-enterprise-api/enterprise_platform/urls.py`)
- Article API → Article serializer: serializes data (evidence: `src/django-enterprise-api/apps/articles/views.py`)
- Article API → Article model: queries and mutates (evidence: `src/django-enterprise-api/apps/articles/views.py`)
- Article API → Valkey cache: caches reads (evidence: `README.md`)
- Article API → PostgreSQL cluster: reads and writes (evidence: `README.md`)
- Article API → Kafka event publisher: publishes lifecycle events (evidence: `src/django-enterprise-api/apps/articles/views.py`)
- User API → User serializers: serializes users (evidence: `src/django-enterprise-api/apps/users/views.py`)
- User API → User profile model: queries and mutates (evidence: `src/django-enterprise-api/apps/users/views.py`)
- User API → Kafka event publisher: publishes lifecycle events (evidence: `src/django-enterprise-api/apps/users/views.py`)
- Kafka event publisher → Kafka broker: sends events (evidence: `README.md`)
- Kafka event publisher → Request correlation: gets request ID (evidence: `src/django-enterprise-api/apps/core/kafka_producer.py`)
- Health and metrics → PostgreSQL cluster: checks readiness (evidence: `src/django-enterprise-api/apps/core/health.py`)
- Health and metrics → Kafka event publisher: checks broker (evidence: `src/django-enterprise-api/apps/core/health.py`)
- PostgreSQL cluster → RustFS object storage: archives WAL (evidence: `README.md`)
- PostgreSQL cluster → Longhorn storage: uses block storage (evidence: `README.md`)
- Kafka broker → Longhorn storage: uses block storage (evidence: `README.md`)
- RustFS object storage → Longhorn storage: uses block storage (evidence: `README.md`)
- Argo CD → Helm platform chart: deploys chart (evidence: `README.md`)
