# galaxyproject/iwc architecture

> Architecture diagram of the GitHub repository galaxyproject/iwc, 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/galaxyproject/iwc
- Repository: https://github.com/galaxyproject/iwc

## Overview

##### Main Components

a. Core Infrastructure Components:
- GitHub Repository (Primary Storage)
- Workflow Registry Systems (Dockstore & WorkflowHub)
- Galaxy Instances (usegalaxy.*)
- Website Component (Vue.js based)

b. Workflow Management Components:
- Workflow Testing System
- CI/CD Pipeline
- Workflow Validation System
- Distribution System

**[Frontend Layer]**
- Website Interface (Vue.js)
- Galaxy Instance UIs

**[Integration Layer]**
- CI/CD Workflows
- Testing Framework
- Workflow Registry APIs

**[Storage Layer]**
- GitHub Repository
- Workflow Registries
- Galaxy Instances

##### Key Relationships

- Bidirectional flow between GitHub and CI/CD systems
- One-way publication flow to registry systems
- Automated distribution to Galaxy instances
- User interaction flows through Galaxy interfaces

##### Component Details

a. Website Component:
**[Website]**
- Vue.js Frontend
- Workflow Catalog
- Documentation System

b. Workflow Processing:
**[Workflow Processing]**
- Validation System
- Testing Framework
- Distribution System

c. Registry Integration:
**[Registry Systems]**
- Dockstore Integration
- WorkflowHub Integration
- Galaxy Instance Distribution

##### Data Flow Indicators

- Arrowheads to show direction of data/control flow

##### Special Elements

- Version control flow
- Testing feedback loops
- Automated deployment paths

##### Implementation Notes

- Clear separation between testing/validation and production deployment
- Points of human intervention (review processes)
- Monitoring and feedback mechanisms

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Frontend
        WEB["Website Interface"]
        COMP["Vue Components"]
        PAGES["Pages"]
        STORE["Data Store"]
    end

    subgraph Integration
        CICD["CI/CD Pipeline"]
        TEST["Workflow Testing"]
        VALID["Workflow Validation"]
        DIST["Distribution System"]
    end

    subgraph Storage
        GH["GitHub Repository"]
        subgraph Workflows
            WF_VGP["VGP Assembly"]
            WF_BAC["Bacterial Genomics"]
            WF_TRANS["Transcriptomics"]
            WF_PROT["Proteomics"]
            WF_VAR["Variant Calling"]
        end
    end

    subgraph Registries
        DS["Dockstore"]
        WH["WorkflowHub"]
    end

    subgraph "Galaxy Instances"
        GAL_EU["UseGalaxy.eu"]
        GAL_US["UseGalaxy.org"]
        GAL_AU["UseGalaxy.org.au"]
    end

    WEB --> COMP
    WEB --> PAGES
    WEB --> STORE
    
    GH --> CICD
    CICD --> TEST
    TEST --> VALID
    VALID --> DIST
    
    DIST --> DS
    DIST --> WH
    DIST --> GAL_EU
    DIST --> GAL_US
    DIST --> GAL_AU
    
    Workflows --> TEST

    %% Click events
    click WEB "https://github.com/galaxyproject/iwc/tree/main/website"
    click COMP "https://github.com/galaxyproject/iwc/tree/main/website/components"
    click PAGES "https://github.com/galaxyproject/iwc/tree/main/website/pages"
    click STORE "https://github.com/galaxyproject/iwc/tree/main/website/stores"
    click CICD "https://github.com/galaxyproject/iwc/tree/main//.github/workflows"
    click TEST "https://github.com/galaxyproject/iwc/blob/main/workflows/wftest.yml"
    click DIST "https://github.com/galaxyproject/iwc/blob/main/scripts/usegalaxy_star_upload.py"
    click WF_VGP "https://github.com/galaxyproject/iwc/tree/main/workflows/VGP-assembly-v2"
    click WF_BAC "https://github.com/galaxyproject/iwc/tree/main/workflows/bacterial_genomics"
    click WF_TRANS "https://github.com/galaxyproject/iwc/tree/main/workflows/transcriptomics"
    click WF_PROT "https://github.com/galaxyproject/iwc/tree/main/workflows/proteomics"
    click WF_VAR "https://github.com/galaxyproject/iwc/tree/main/workflows/variant-calling"

    %% Styling
    classDef frontend fill:#e1bee7,stroke:#6a1b9a
    classDef integration fill:#bbdefb,stroke:#1565c0
    classDef storage fill:#c8e6c9,stroke:#2e7d32
    classDef registry fill:#ffe0b2,stroke:#ef6c00
    classDef galaxy fill:#ffcdd2,stroke:#c62828

    class WEB,COMP,PAGES,STORE frontend
    class CICD,TEST,VALID,DIST integration
    class GH,WF_VGP,WF_BAC,WF_TRANS,WF_PROT,WF_VAR storage
    class DS,WH registry
    class GAL_EU,GAL_US,GAL_AU galaxy
```
