# fiware/helm-charts architecture

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

- Interactive diagram: https://gitdiagram.com/fiware/helm-charts
- Repository: https://github.com/fiware/helm-charts

## Overview

##### Main Components Identification
The system should be represented as a Kubernetes-based deployment architecture with the following key components:

a. Core Components:
- FIWARE Context Broker (central/mandatory component)
- Individual Generic Enablers (represented by separate Helm charts)
- Supporting Infrastructure Services

b. Chart Categories to represent:
- Core Services (e.g., Orion, Scorpio Broker)
- IoT Agents (iotagent-json, iotagent-ul)
- Security Components (Keyrock, endpoint-auth-service)
- API Management (api-umbrella)
- Business Framework Components (business-api-ecosystem)

##### Specific Implementation Details

Technical aspects:
- Kubernetes resource definitions (Deployments, Services, etc.)
- Helm chart relationships and dependencies
- Configuration options (values.yaml references)
- Integration points with external systems
- Security boundaries and access controls

##### Additional Elements

- Version compatibility matrix
- Resource requirements
- Scaling indicators (HPA configurations)
- External dependencies
- Configuration parameters

##### Notes for Implementation

- Maintain clear separation between infrastructure and application layers
- Central role of the Context Broker
- Optional/required component relationships
- Scaling capabilities
- Document security boundaries
- Integration points with external systems

Remember to include annotations for important configuration points and maintain a balance between detail and clarity, focusing on the architectural relationships rather than implementation specifics.

## Diagram (Mermaid)

```mermaid
graph TB
    %% Platform Layer
    subgraph Platform["Platform Management"]
        HR["Helm Repository"]
        CRI["Chart Repository Interface"]
        AH["Artifact Hub"]
    end

    %% Kubernetes Layer
    subgraph K8s["Kubernetes Infrastructure"]
        DC["Deployment Controllers"]:::k8s
        SA["Service Accounts"]:::k8s
        CM["ConfigMaps/Secrets"]:::k8s
        ING["Ingress/Routes"]:::k8s
    end

    %% FIWARE Core Components
    subgraph Core["FIWARE Core"]
        CB["Orion Context Broker"]:::core
        click CB "https://github.com/FIWARE/helm-charts/tree/main/charts/orion"
        SCB["Scorpio Broker"]:::core
        click SCB "https://github.com/FIWARE/helm-charts/tree/main/charts/scorpio-broker"
        MINT["Mintaka Historical Data"]:::core
        click MINT "https://github.com/FIWARE/helm-charts/tree/main/charts/mintaka"
    end

    %% IoT Layer
    subgraph IoT["IoT Components"]
        IOTJ["IoT Agent JSON"]:::iot
        click IOTJ "https://github.com/FIWARE/helm-charts/tree/main/charts/iotagent-json"
        IOTU["IoT Agent Ultralight"]:::iot
        click IOTU "https://github.com/FIWARE/helm-charts/tree/main/charts/iotagent-ul"
    end

    %% Security Layer
    subgraph Security["Security Components"]
        KR["Keyrock Identity Management"]:::security
        click KR "https://github.com/FIWARE/helm-charts/tree/main/charts/keyrock"
        EAS["Endpoint Authentication Service"]:::security
        click EAS "https://github.com/FIWARE/helm-charts/tree/main/charts/endpoint-auth-service"
        ISS["iShare Satellite"]:::security
        click ISS "https://github.com/FIWARE/helm-charts/tree/main/charts/ishare-satellite"
        CCS["Credentials Config Service"]:::security
        click CCS "https://github.com/FIWARE/helm-charts/tree/main/charts/credentials-config-service"
    end

    %% API Management
    subgraph API["API Management"]
        AU["API Umbrella"]:::api
        click AU "https://github.com/FIWARE/helm-charts/tree/main/charts/api-umbrella"
    end

    %% Business Framework
    subgraph Business["Business Framework"]
        BAE["Business API Ecosystem"]:::business
        click BAE "https://github.com/FIWARE/helm-charts/tree/main/charts/business-api-ecosystem"
        BAS["BAE Activation Service"]:::business
        click BAS "https://github.com/FIWARE/helm-charts/tree/main/charts/bae-activation-service"
        PDP["DSBA Policy Decision Point"]:::business
        click PDP "https://github.com/FIWARE/helm-charts/tree/main/charts/dsba-pdp"
        CM["Contract Management"]:::business
        click CM "https://github.com/FIWARE/helm-charts/tree/main/charts/contract-management"
        PAP["Policy Administration"]:::business
        click PAP "https://github.com/FIWARE/helm-charts/tree/main/charts/odrl-pap"
    end

    %% Relationships
    HR --> CRI
    CRI --> AH
    K8s --> Core
    K8s --> IoT
    K8s --> Security
    K8s --> API
    K8s --> Business

    CB <--> SCB
    CB <--> MINT
    CB <--> IOTJ
    CB <--> IOTU
    
    KR --> EAS
    KR --> ISS
    KR --> CCS
    
    AU --> CB
    
    BAE --> BAS
    BAE --> PDP
    BAE --> CM
    BAE --> PAP

    %% Styles
    classDef core fill:#3498db,stroke:#2980b9,color:white
    classDef iot fill:#2ecc71,stroke:#27ae60,color:white
    classDef security fill:#f1c40f,stroke:#f39c12,color:black
    classDef k8s fill:#95a5a6,stroke:#7f8c8d,color:white
    classDef api fill:#e67e22,stroke:#d35400,color:white
    classDef business fill:#9b59b6,stroke:#8e44ad,color:white

    %% Legend
    subgraph Legend
        L1["Core Components"]:::core
        L2["IoT Services"]:::iot
        L3["Security Services"]:::security
        L4["Infrastructure"]:::k8s
        L5["API Management"]:::api
        L6["Business Framework"]:::business
    end
```
