# colav/impactu architecture

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

- Interactive diagram: https://gitdiagram.com/colav/impactu
- Repository: https://github.com/colav/impactu

## Overview

##### Project type and purpose
- From the file tree and the README (“Colav Impactu Issues and Documentation”), this is not a typical full-stack service but a DevOps/CI-CD-orchestration repository. It centralizes:
- Configuration files per environment (configs/)
- Documentation (doc/)
- Release notes (releases/)
- Workflow definitions (workflows/)
- Its purpose is to store and version “Impactu” pipeline definitions (kahi_impactu…yml), environment configs (oxomoc/colombia_config.py), sample pipelines (workflows/samples), and documentation for Colav’s Impactu process and integration (e.g., with DSpace).

##### File structure
- Top-level directories:
- configs/oxomoc – environment-specific Python config
- doc/ – Markdown files capturing processes, data-product definitions
- releases/ – human-readable release notes by date/language
- workflows/impactu – pipeline-as-code YAMLs for production/dev/Dspace
- workflows/samples – sample workflows and README
- No application “src/” folder: this repo’s “runtime” is the CI/CD system (e.g., GitHub Actions or an orchestration engine) that reads these workflows.
- Key files: .gitignore, LICENSE, README.md

##### README for additional insights
- Confirms that the repo serves as both an “issues and documentation” hub.

##### Detail
- Separate workflow paths (prod vs dev vs sample) if space permits.
- Call out the config file lookup step in the pipeline.

Layer 1: Developer → Git Repo
Layer 2: CI/CD Runner (pipeline engine)
Layer 3: External Services (Impactu, DSpace, Sample)
Layer 4: Artifacts (releases/, published docs)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Layer 1: User Interaction
    Developer["Developer / User"]:::external

    %% Layer 2: Git Repository
    subgraph "Git Repository" 
        direction TB
        GitRepo["Git Repository"]:::storage
        configs["configs/oxomoc"]:::storage
        documentation["Documentation<br/>doc/"]:::doc
        releases["Release Notes<br/>releases/"]:::storage
        workflows["Workflows<br/>workflows/"]:::pipeline
    end

    %% Layer 3: CI/CD Runner
    runner["CI/CD Runner"]:::pipeline

    %% Layer 4: External Services
    subgraph "External Services"
        direction TB
        impactuProd["Impactu Service"]:::external
        impactuDev["Dev Impactu Service"]:::external
        dspace["DSpace Service"]:::external
        sample["Sample Pipeline<br/>VIP"]:::external
    end

    %% Layer 5: Artifacts & Publishing
    docsSite["Documentation Site"]:::doc

    %% Connections
    Developer -->|"git push / pull request"| GitRepo
    GitRepo -->|"trigger workflow"| runner
    runner -->|"reads config"| configs
    runner -->|"reads workflows"| workflows
    runner -->|"executes"| impactuProd
    runner -->|"executes"| impactuDev
    runner -->|"executes"| dspace
    runner -->|"executes"| sample
    runner -->|"publishes release notes"| releases
    GitRepo -->|"serves docs"| docsSite

    %% Click Events
    click GitRepo "https://github.com/colav/impactu/tree/main//"
    click configs "https://github.com/colav/impactu/blob/main/configs/oxomoc/colombia_config.py"
    click documentation "https://github.com/colav/impactu/tree/main/doc/"
    click releases "https://github.com/colav/impactu/tree/main/releases/"
    click workflows "https://github.com/colav/impactu/tree/main/workflows/"
    click impactuProd "https://github.com/colav/impactu/blob/main/workflows/impactu/kahi_impactu.yml"
    click impactuDev "https://github.com/colav/impactu/blob/main/workflows/impactu/kahi_impactu_dev.yml"
    click dspace "https://github.com/colav/impactu/blob/main/workflows/impactu/kahi_impactu_dspace.yml"
    click sample "https://github.com/colav/impactu/blob/main/workflows/samples/kahi_sample_vip.yml"

    %% Styles
    classDef storage fill:#B3CDE3,stroke:#333,stroke-width:1px
    classDef pipeline fill:#FBB4AE,stroke:#333,stroke-width:1px
    classDef external fill:#C7E9C0,stroke:#333,stroke-width:1px
    classDef doc fill:#D9D9D9,stroke:#333,stroke-width:1px
```
