# oneconvergence/dkubex-helm architecture

> Architecture diagram of the GitHub repository oneconvergence/dkubex-helm, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/oneconvergence/dkubex-helm
- Repository: https://github.com/oneconvergence/dkubex-helm

## Overview

##### Project type and purpose
- This is not a traditional “app” codebase but a Helm-based deployment repository. It contains two distinct Helm charts—“dkubex” and “securellm”—plus an index.yaml to serve them from a chart repo.
- Purpose: package and manage Kubernetes releases of the dkubex service and the securellm stack (which itself pulls in a Supabase subchart).

##### File structure
- Top level:
- README.md (high-level repo description)
- dkubex/ (Helm chart for dkubex service)
- securellm/ (Helm chart for securellm stack)
- index.yaml (Helm chart repository index)
- dkubex/ contains Chart.yaml, values.yaml, and a templates/ folder with ConfigMap, ServiceAccount, hooks (pre-upgrade, uninstall), install manifests.
- securellm/ contains its own Chart.yaml, values.yaml, templates/ (ingress & securellm Deployment), plus a charts/supabase/ subdirectory.
- charts/supabase/ is a full subchart with templates broken into auth/, db/, kong/, rest/ directories, each defining Deployments, Services, Ingresses, Roles, PVCs, etc.

##### README
- Minimal description: “Repository to hold dkubex helm release charts.”

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Packaging & Deployment Layer
    subgraph "Packaging & Deployment"
        direction TB
        Developer["Developer / CI/CD"]:::app
        HelmClient["Helm Client (v3)"]:::helm
        ChartRepo["Chart Repository\n(index.yaml)"]:::helm
        dkubexChart["dkubex Chart"]:::helm
        dkubexValues["dkubex values.yaml"]:::helm
        dkubexTemplates["dkubex templates"]:::helm
        securellmChart["securellm Chart"]:::helm
        securellmValues["securellm values.yaml"]:::helm
        securellmTemplates["securellm templates"]:::helm

        Developer -->|push charts| ChartRepo
        HelmClient -->|fetch charts| ChartRepo
        ChartRepo --> dkubexChart
        ChartRepo --> securellmChart
        dkubexChart --> dkubexValues
        dkubexChart --> dkubexTemplates
        securellmChart --> securellmValues
        securellmChart --> securellmTemplates
        HelmClient -->|"install/upgrade"| KubernetesAPI
    end

    %% Cluster Control Plane
    subgraph "Cluster Control Plane" 
        direction TB
        KubernetesAPI["Kubernetes API"]:::control
        Scheduler["Scheduler"]:::control
        KubernetesAPI --> Scheduler
    end

    %% Deployed Applications
    subgraph "Deployed Applications"
        direction TB

        %% dkubex Deployment
        subgraph "dkubex Service" 
            direction TB
            dkubexDeployment["Deployment"]:::app
            dkubexConfig["ConfigMap"]:::app
            dkubexSA["ServiceAccount"]:::app
            dkubexService["Service"]:::app
            dkubexHooks["Lifecycle Hooks"]:::hook
            dkubexRegistry["Registry Secret"]:::app
            dkubexDeployment --> dkubexService
            dkubexService --> dkubexDeployment
        end

        %% securellm Deployment
        subgraph "securellm Stack"
            direction TB
            securellmApp["securellm Deployment & Service"]:::app
            securellmIngress["Ingress"]:::app

            securellmApp --> securellmIngress

            %% Supabase Subchart
            subgraph "Supabase Subchart"
                direction TB
                supaAuth["Auth Service"]:::app
                supaDB["Postgres DB"]:::db
                supaKong["Kong API Gateway"]:::app
                supaRest["REST Service"]:::app
                supaSecrets["Shared Secrets"]:::app

                supaAuth --> supaDB
                supaKong --> supaRest
                supaRest --> supaDB
                supaIngressAuth["Ingress"]:::app
                supaIngressDB["Ingress"]:::app
                supaIngressRest["Ingress"]:::app

                supaAuth --> supaIngressAuth
                supaDB --> supaIngressDB
                supaRest --> supaIngressRest
            end

            securellmIngress --> supaKong
            securellmIngress --> securellmApp
        end
    end

    %% Click events for component mappings
    click ChartRepo "https://github.com/oneconvergence/dkubex-helm/blob/main/index.yaml"
    click dkubexChart "https://github.com/oneconvergence/dkubex-helm/blob/main/dkubex/Chart.yaml"
    click dkubexValues "https://github.com/oneconvergence/dkubex-helm/blob/main/dkubex/values.yaml"
    click dkubexTemplates "https://github.com/oneconvergence/dkubex-helm/tree/main/dkubex/templates/"
    click dkubexConfig "https://github.com/oneconvergence/dkubex-helm/blob/main/dkubex/templates/configmap.yaml"
    click dkubexSA "https://github.com/oneconvergence/dkubex-helm/blob/main/dkubex/templates/serviceaccount.yaml"
    click dkubexRegistry "https://github.com/oneconvergence/dkubex-helm/blob/main/dkubex/templates/registry-secret.yaml"
    click dkubexDeployment "https://github.com/oneconvergence/dkubex-helm/blob/main/dkubex/templates/install.yaml"
    click dkubexHooks "https://github.com/oneconvergence/dkubex-helm/blob/main/dkubex/templates/hooks/upgrade.yaml"
    click dkubexHooks "https://github.com/oneconvergence/dkubex-helm/blob/main/dkubex/templates/hooks/uninstall.yaml"
    click dkubexTemplates "https://github.com/oneconvergence/dkubex-helm/blob/main/dkubex/templates/_helpers.tpl"

    click securellmChart "https://github.com/oneconvergence/dkubex-helm/blob/main/securellm/Chart.yaml"
    click securellmValues "https://github.com/oneconvergence/dkubex-helm/blob/main/securellm/values.yaml"
    click securellmTemplates "https://github.com/oneconvergence/dkubex-helm/tree/main/securellm/templates/"
    click securellmApp "https://github.com/oneconvergence/dkubex-helm/blob/main/securellm/templates/securellm.yaml"
    click securellmIngress "https://github.com/oneconvergence/dkubex-helm/blob/main/securellm/templates/ingress.yaml"
    click securellmTemplates "https://github.com/oneconvergence/dkubex-helm/blob/main/securellm/templates/_helpers.tpl"

    click supaChart "https://github.com/oneconvergence/dkubex-helm/blob/main/securellm/charts/supabase/Chart.yaml"
    click supaValues "https://github.com/oneconvergence/dkubex-helm/blob/main/securellm/charts/supabase/values.yaml"
    click supaAuth "https://github.com/oneconvergence/dkubex-helm/blob/main/securellm/charts/supabase/templates/auth/deployment.yaml"
    click supaDB "https://github.com/oneconvergence/dkubex-helm/blob/main/securellm/charts/supabase/templates/db/deployment.yaml"
    click supaKong "https://github.com/oneconvergence/dkubex-helm/blob/main/securellm/charts/supabase/templates/kong/deployment.yaml"
    click supaRest "https://github.com/oneconvergence/dkubex-helm/blob/main/securellm/charts/supabase/templates/rest/deployment.yaml"
    click supaSecrets "https://github.com/oneconvergence/dkubex-helm/blob/main/securellm/charts/supabase/templates/secrets.yaml"
    click supaDB "https://github.com/oneconvergence/dkubex-helm/blob/main/securellm/charts/supabase/templates/db/pvc.yaml"
    click supaDB "https://github.com/oneconvergence/dkubex-helm/blob/main/securellm/charts/supabase/templates/db/pv.yaml"
    click supaAuth "https://github.com/oneconvergence/dkubex-helm/blob/main/securellm/charts/supabase/templates/auth/serviceaccount.yaml"
    click supaDB "https://github.com/oneconvergence/dkubex-helm/blob/main/securellm/charts/supabase/templates/db/serviceaccount.yaml"
    click supaKong "https://github.com/oneconvergence/dkubex-helm/blob/main/securellm/charts/supabase/templates/kong/serviceaccount.yaml"
    click supaRest "https://github.com/oneconvergence/dkubex-helm/blob/main/securellm/charts/supabase/templates/rest/serviceaccount.yaml"
    click supaAuth "https://github.com/oneconvergence/dkubex-helm/blob/main/securellm/charts/supabase/templates/auth/config.yaml"
    click supaDB "https://github.com/oneconvergence/dkubex-helm/blob/main/securellm/charts/supabase/templates/db/init-config.yaml"
    click supaKong "https://github.com/oneconvergence/dkubex-helm/blob/main/securellm/charts/supabase/templates/kong/config.yaml"
    click supaRest "https://github.com/oneconvergence/dkubex-helm/blob/main/securellm/charts/supabase/templates/rest/config.yaml"
    click supaIngressAuth "https://github.com/oneconvergence/dkubex-helm/blob/main/securellm/charts/supabase/templates/auth/ingress.yaml"
    click supaIngressDB "https://github.com/oneconvergence/dkubex-helm/blob/main/securellm/charts/supabase/templates/db/ingress.yaml"
    click supaIngressRest "https://github.com/oneconvergence/dkubex-helm/blob/main/securellm/charts/supabase/templates/rest/ingress.yaml"
    click supaTemplates "https://github.com/oneconvergence/dkubex-helm/blob/main/securellm/charts/supabase/templates/_helpers.tpl"

    %% Styles
    classDef helm fill:#cce5ff,stroke:#004085;
    classDef control fill:#e2e3e5,stroke:#d6d8db;
    classDef app fill:#d4edda,stroke:#155724;
    classDef db fill:#ffe5b4,stroke:#cc5200;
    classDef hook stroke-dasharray:5 5;
```
