# jtama/quarkus-extension-demo architecture

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

- Interactive diagram: https://gitdiagram.com/jtama/quarkus-extension-demo
- Repository: https://github.com/jtama/quarkus-extension-demo

## Overview

##### Main Components

a. Extension Core Components:
- Runtime Module
- Deployment Module
- Integration Tests
- Conference Provider
- Configuration Provider

b. Build-time vs Runtime separation (crucial for Quarkus extensions):
- Build-time components (deployment module)
- Runtime components
- Dev Services and Dev UI components

##### Component Relationships

**[Build Time]**
**Deployment Module**
- AcmeConfigurationProviderProcessor
- DevServicesProcessor
- ConfigurationProviderDevUIProcessor
- Build Items Generation

**[Runtime]**
**Runtime Module**
- Config Sources
- Environment Provider
- Runtime Configuration

**[Development]**
**Dev UI/Services**
- Configuration Provider Card
- JSON RPC Service

**[Testing]**
**Integration Tests**
- Custom Resource Tests

##### Specific Elements

- Blue: Build-time components
- Green: Runtime components
- Orange: Development tools
- Gray: Testing components

b. Component Interactions:
- Build-time to runtime flow
- Configuration source chain
- Extension points
- Dev services integration

##### Key Architectural Aspects to Highlight

- Configuration Provider Architecture:
- AcmeConfigSource
- ConfigSourceFactory
- Environment Provider integration

- Build Time Processing:
- Processors
- Build Items
- Transformers

- Development Support:
- Dev Services
- Dev UI integration
- Configuration management

##### Important Details

- Extension points clearly
- Integration with Quarkus core
- Configuration flow
- Build-time vs runtime boundary
- Test coverage scope

Top: Build-time processing
Middle: Runtime components
Bottom: Development and testing tools
Side: External integrations

Remember to:
- Keep the main extension logic flow clear
- Clear separation between build and runtime phases
- Configuration injection points
- Major integration points

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph Build["Build Time Components"]
        direction TB
        DM["Deployment Module"]:::buildtime
        ACPP["AcmeConfigurationProviderProcessor"]:::buildtime
        DSP["DevServicesProcessor"]:::buildtime
        CPDUP["ConfigurationProviderDevUIProcessor"]:::buildtime
        BIG["Build Items Generation"]:::buildtime
        BTCFG["Build Time Configuration"]:::buildtime
        
        DM --> ACPP
        DM --> DSP
        DM --> CPDUP
        DM --> BIG
        DM --> BTCFG
    end

    subgraph Runtime["Runtime Components"]
        direction TB
        RM["Runtime Module"]:::runtime
        CS["Config Sources"]:::runtime
        EP["Environment Provider"]:::runtime
        RC["Runtime Configuration"]:::runtime
        CSF["Config Source Factory"]:::runtime
        
        RM --> CS
        RM --> EP
        RM --> RC
        RM --> CSF
    end

    subgraph Dev["Development Tools"]
        direction TB
        DUIS["Dev UI/Services"]:::devtools
        CPC["Configuration Provider Card"]:::devtools
        JRPC["JSON RPC Service"]:::devtools
        
        DUIS --> CPC
        DUIS --> JRPC
    end

    subgraph Testing["Testing Components"]
        direction TB
        IT["Integration Tests"]:::testing
        CRT["Custom Resource Tests"]:::testing
        CPT["Conference Provider Tests"]:::testing
        
        IT --> CRT
        IT --> CPT
    end

    Build --> Runtime
    Runtime --> Dev
    Build --> Dev
    Runtime --> Testing

    classDef buildtime fill:#2196F3,stroke:#1565C0,color:white
    classDef runtime fill:#4CAF50,stroke:#388E3C,color:white
    classDef devtools fill:#FF9800,stroke:#F57C00,color:white
    classDef testing fill:#9E9E9E,stroke:#616161,color:white

    click DM "https://github.com/jtama/quarkus-extension-demo/tree/main/deployment/src/main/java/org/acme/configurationProvider/deployment/"
    click ACPP "https://github.com/jtama/quarkus-extension-demo/blob/main/deployment/src/main/java/org/acme/configurationProvider/deployment/AcmeConfigurationProviderProcessor.java"
    click DSP "https://github.com/jtama/quarkus-extension-demo/blob/main/deployment/src/main/java/org/acme/configurationProvider/deployment/devservice/DevServicesProcessor.java"
    click CPDUP "https://github.com/jtama/quarkus-extension-demo/blob/main/deployment/src/main/java/org/acme/configurationProvider/deployment/devui/ConfigurationProviderDevUIProcessor.java"
    click BTCFG "https://github.com/jtama/quarkus-extension-demo/blob/main/deployment/src/main/java/org/acme/configurationProvider/deployment/AcmeConfigurationBuildTimeConfiguration.java"
    
    click RM "https://github.com/jtama/quarkus-extension-demo/tree/main/runtime/src/main/java/org/acme/configurationProvider/runtime/"
    click CS "https://github.com/jtama/quarkus-extension-demo/blob/main/runtime/src/main/java/org/acme/configurationProvider/runtime/AcmeConfigSource.java"
    click EP "https://github.com/jtama/quarkus-extension-demo/blob/main/runtime/src/main/java/org/acme/configurationProvider/runtime/EnvironmentProviderClient.java"
    click RC "https://github.com/jtama/quarkus-extension-demo/blob/main/runtime/src/main/java/org/acme/configurationProvider/runtime/EnvironmentRuntimeConfiguration.java"
    click CSF "https://github.com/jtama/quarkus-extension-demo/blob/main/runtime/src/main/java/org/acme/configurationProvider/runtime/AcmeConfigSourceFactory.java"
    
    click CPC "https://github.com/jtama/quarkus-extension-demo/blob/main/deployment/src/main/resources/dev-ui/qwc-configuration-provider-card.js"
    click JRPC "https://github.com/jtama/quarkus-extension-demo/blob/main/runtime/src/main/java/org/acme/configurationProvider/devui/ConfigurationProviderJsonRPCService.java"
    
    click IT "https://github.com/jtama/quarkus-extension-demo/tree/main/integration-tests/"
    click CRT "https://github.com/jtama/quarkus-extension-demo/blob/main/integration-tests/src/test/java/org/acme/configurationProvider/it/CustomResourceTest.java"
    click CPT "https://github.com/jtama/quarkus-extension-demo/blob/main/conference-provider/src/test/java/org/acme/ConferencesResourceTest.java"
```
