# jauderho/sandbox architecture

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

- Interactive diagram: https://gitdiagram.com/jauderho/sandbox
- Repository: https://github.com/jauderho/sandbox

## Overview

##### Project type and purpose
- This is a “sandbox” monorepo of dozens of small, standalone tools and utilities (mostly Python-based) packaged as Docker containers for experimentation.

##### File structure
- Top‐level:
– Configuration and policies (.allstar, .github/, SECURITY.md, CODE_OF_CONDUCT).
– Root‐level Dockerfile (probably builds a generic sandbox or base image).
– scripts/ folder containing utility scripts to update dependencies.
- Each tool directory (e.g. awscli/, datasette/, jless/, open-interpreter/) contains:
– A Dockerfile (often multiple variants: ubuntu, alpine, curl).
– A Python dependency manifest (requirements.txt, Pipfile or pyproject.toml).
– A lock file (uv.lock, Pipfile.lock) where applicable.

##### Elements
- Clear component labels: Repo, CI/CD, Tool A, Tool B, Scripts, Registry, Developer.
– Repo → GitHub Actions (code push triggers).
– GitHub Actions → Docker Builds (per-tool).
– Docker Builds → Container Registry (publish).
– Developer ↔ Docker Containers (local pulls/runs).
– Another for “CI/CD pipeline.”
– Another for “build artifacts/containers.”

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% External actor
    Dev["Developer"]:::external

    %% Monorepo Repository
    subgraph "Monorepo Repository" 
        direction TB
        RepoRoot["/ (Repository Root)"]:::repoComp
        subgraph "Policy & Security Configurations"
            direction TB
            Allstar[".allstar/"]:::config
            GitMeta[".github/"]:::config
        end
        subgraph "CI/CD Workflows"
            direction TB
            Workflows[".github/workflows/"]:::ci
        end
        RootDocker["Dockerfile"]:::repoComp
        subgraph "Cross-cutting Utility Scripts"
            direction TB
            UpdDeps1["updateDockerDeps.sh"]:::scripts
            UpdDeps2["updatePythonDeps.sh"]:::scripts
            UpdDeps3["updatePythonDepsArm.sh"]:::scripts
            UpdDeps4["updatePythonDepsUV.sh"]:::scripts
        end
        subgraph "Tool Contexts"
            direction TB
            subgraph "Primary Tools"
                awscli["awscli/ Dockerfile & Manifests"]:::tool
                cryptolyzer["cryptolyzer/ Dockerfile & Manifests"]:::tool
                openint["open-interpreter/ Dockerfile & Manifests"]:::tool
                jless["jless/ Dockerfile & Manifests"]:::tool
                datasette["datasette/ Dockerfile & Manifests"]:::tool
                visidata["done/visidata/ Dockerfile & Manifests"]:::tool
                sslyze["done/sslyze/ Dockerfile & Manifests"]:::tool
            end
            subgraph "Done Tools Group"
                direction TB
                DoneGroup["done/ (other tools)"]:::tool
            end
        end
    end

    %% CI/CD Service
    subgraph "GitHub Actions CI/CD" 
        direction TB
        GHActions["GitHub Actions"]:::ci
    end

    %% Docker Builds
    subgraph "Docker Build System"
        direction TB
        Build["Docker Build per Tool"]:::ci
    end

    %% Container Registry
    Registry["Container Registry"]:::registry

    %% Relationships
    Dev -->|clones/pushes code| RepoRoot
    RepoRoot -->|triggers workflows| GHActions
    GHActions -->|runs scripts| UpdDeps1
    GHActions -->|runs scripts| UpdDeps2
    GHActions -->|runs scripts| UpdDeps3
    GHActions -->|runs scripts| UpdDeps4
    GHActions -->|builds images| Build
    Build -->|uses contexts| awscli
    Build --> cryptolyzer
    Build --> openint
    Build --> jless
    Build --> datasette
    Build --> visidata
    Build --> sslyze
    Build --> DoneGroup
    Build -->|pushes images| Registry
    Dev -->|pulls/runs containers| Registry

    %% Click Events
    click RepoRoot "https://github.com/jauderho/sandbox/tree/main//"
    click Allstar "https://github.com/jauderho/sandbox/tree/main//.allstar/"
    click GitMeta "https://github.com/jauderho/sandbox/tree/main//.github/workflows/"
    click Workflows "https://github.com/jauderho/sandbox/tree/main//.github/workflows/"
    click RootDocker "https://github.com/jauderho/sandbox/tree/main//Dockerfile"
    click UpdDeps1 "https://github.com/jauderho/sandbox/blob/main//scripts/updateDockerDeps.sh"
    click UpdDeps2 "https://github.com/jauderho/sandbox/blob/main//scripts/updatePythonDeps.sh"
    click UpdDeps3 "https://github.com/jauderho/sandbox/blob/main//scripts/updatePythonDepsArm.sh"
    click UpdDeps4 "https://github.com/jauderho/sandbox/blob/main//scripts/updatePythonDepsUV.sh"
    click awscli "https://github.com/jauderho/sandbox/tree/main//awscli/Dockerfile"
    click cryptolyzer "https://github.com/jauderho/sandbox/tree/main//cryptolyzer/Dockerfile"
    click openint "https://github.com/jauderho/sandbox/tree/main//open-interpreter/Dockerfile"
    click jless "https://github.com/jauderho/sandbox/tree/main//jless/Dockerfile"
    click datasette "https://github.com/jauderho/sandbox/tree/main//datasette/Pipfile"
    click visidata "https://github.com/jauderho/sandbox/tree/main//done/visidata/Dockerfile"
    click sslyze "https://github.com/jauderho/sandbox/tree/main//done/sslyze/Dockerfile"
    click DoneGroup "https://github.com/jauderho/sandbox/tree/main//done/"

    %% Styles
    classDef external fill:#f9c,stroke:#333,stroke-width:1px
    classDef repoComp fill:#bbdefb,stroke:#1e88e5,stroke-width:1px
    classDef config fill:#e3f2fd,stroke:#64b5f6,stroke-width:1px
    classDef ci fill:#c8e6c9,stroke:#388e3c,stroke-width:1px
    classDef scripts fill:#ffe0b2,stroke:#f57c00,stroke-width:1px
    classDef tool fill:#fff9c4,stroke:#fbc02d,stroke-width:1px
    classDef registry fill:#e1bee7,stroke:#8e24aa,stroke-width:1px
```
