# victor3spoir/boilerplates architecture

> Architecture diagram of the GitHub repository victor3spoir/boilerplates, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-25). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/victor3spoir/boilerplates
- Repository: https://github.com/victor3spoir/boilerplates
- Video tour (about a minute): https://gitdiagram.com/victor3spoir/boilerplates/video

## Overview

This repository is a collection of reusable infrastructure boilerplates, not an integrated application. The principal workflow is an engineer choosing a template, then copying and adapting it for a project. The graph groups the major template families documented in the README; those files are independent starting points rather than a connected execution pipeline. Sampled source is sparse, so relationships between individual templates and external services are not inferred.

Main entry points: [`docker-compose`](https://github.com/victor3spoir/boilerplates/tree/main/docker-compose) (Compose catalog), [`docker-compose/databases`](https://github.com/victor3spoir/boilerplates/tree/main/docker-compose/databases) (Databases), [`docker-compose/brokers`](https://github.com/victor3spoir/boilerplates/tree/main/docker-compose/brokers) (Brokers), [`docker-compose/iam`](https://github.com/victor3spoir/boilerplates/tree/main/docker-compose/iam) (Identity)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_containers["Container stacks"]
  node_compose["Compose catalog"]
  node_databases["Databases"]
  node_brokers["Brokers"]
  node_iam["Identity"]
  node_observability["Observability"]
  node_services["Service stacks"]
  node_dockerfiles["Docker images"]
end

subgraph group_orchestration["Cluster templates"]
  node_kubernetes["Kubernetes manifests"]
end

subgraph group_provisioning["Host provisioning"]
  node_ansible["Ansible automation"]
  node_cloudinit["Cloud bootstrap"]
  node_terraform["Terraform/OpenTofu"]
end

subgraph group_developer["Developer environments"]
  node_devcontainers["Dev containers"]
end

subgraph group_delivery["Delivery templates"]
  node_gitlab["GitLab CI templates"]
end

node_engineer(("Engineer"))
node_project["Project setup"]

node_engineer -->|"chooses and adapts"| node_compose
node_engineer -->|"chooses and adapts"| node_dockerfiles
node_engineer -->|"chooses and adapts"| node_kubernetes
node_engineer -->|"chooses and adapts"| node_ansible
node_engineer -->|"chooses and adapts"| node_cloudinit
node_engineer -->|"chooses and adapts"| node_terraform
node_engineer -->|"chooses and adapts"| node_devcontainers
node_engineer -->|"chooses and adapts"| node_gitlab
node_engineer -->|"chooses and adapts"| node_databases
node_engineer -->|"chooses and adapts"| node_brokers
node_engineer -->|"chooses and adapts"| node_iam
node_engineer -->|"chooses and adapts"| node_observability
node_engineer -->|"chooses and adapts"| node_services
node_compose -->|"copied into"| node_project
node_dockerfiles -->|"adapted for"| node_project
node_kubernetes -->|"adapted for"| node_project
node_ansible -->|"adapted for"| node_project
node_cloudinit -->|"adapted for"| node_project
node_terraform -->|"adapted for"| node_project
node_devcontainers -->|"adapted for"| node_project
node_gitlab -->|"adapted for"| node_project
node_databases -->|"adapted for"| node_project
node_brokers -->|"adapted for"| node_project
node_iam -->|"adapted for"| node_project
node_observability -->|"adapted for"| node_project
node_services -->|"adapted for"| node_project

click node_compose "https://github.com/victor3spoir/boilerplates/tree/main/docker-compose"
click node_databases "https://github.com/victor3spoir/boilerplates/tree/main/docker-compose/databases"
click node_brokers "https://github.com/victor3spoir/boilerplates/tree/main/docker-compose/brokers"
click node_iam "https://github.com/victor3spoir/boilerplates/tree/main/docker-compose/iam"
click node_observability "https://github.com/victor3spoir/boilerplates/tree/main/docker-compose/observability"
click node_services "https://github.com/victor3spoir/boilerplates/tree/main/docker-compose/services"
click node_dockerfiles "https://github.com/victor3spoir/boilerplates/tree/main/docker"
click node_kubernetes "https://github.com/victor3spoir/boilerplates/tree/main/kubernetes"
click node_ansible "https://github.com/victor3spoir/boilerplates/tree/main/ansible"
click node_cloudinit "https://github.com/victor3spoir/boilerplates/tree/main/cloud-config"
click node_terraform "https://github.com/victor3spoir/boilerplates/tree/main/terraform-tofu"
click node_devcontainers "https://github.com/victor3spoir/boilerplates/tree/main/devcontainers"
click node_gitlab "https://github.com/victor3spoir/boilerplates/tree/main/gitlab"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_compose,node_databases,node_brokers,node_iam,node_observability,node_services,node_dockerfiles toneBlue
class node_kubernetes toneAmber
class node_ansible,node_cloudinit,node_terraform toneMint
class node_devcontainers toneRose
class node_gitlab,node_engineer,node_project toneIndigo
```

## Components

### Container stacks

- [Compose catalog](https://github.com/victor3spoir/boilerplates/tree/main/docker-compose): `docker-compose`
- [Databases](https://github.com/victor3spoir/boilerplates/tree/main/docker-compose/databases): `docker-compose/databases`
- [Brokers](https://github.com/victor3spoir/boilerplates/tree/main/docker-compose/brokers): `docker-compose/brokers`
- [Identity](https://github.com/victor3spoir/boilerplates/tree/main/docker-compose/iam): `docker-compose/iam`
- [Observability](https://github.com/victor3spoir/boilerplates/tree/main/docker-compose/observability): `docker-compose/observability`
- [Service stacks](https://github.com/victor3spoir/boilerplates/tree/main/docker-compose/services): `docker-compose/services`
- [Docker images](https://github.com/victor3spoir/boilerplates/tree/main/docker): `docker`

### Cluster templates

- [Kubernetes manifests](https://github.com/victor3spoir/boilerplates/tree/main/kubernetes): `kubernetes`

### Host provisioning

- [Ansible automation](https://github.com/victor3spoir/boilerplates/tree/main/ansible): `ansible`
- [Cloud bootstrap](https://github.com/victor3spoir/boilerplates/tree/main/cloud-config): `cloud-config`
- [Terraform/OpenTofu](https://github.com/victor3spoir/boilerplates/tree/main/terraform-tofu): `terraform-tofu`

### Developer environments

- [Dev containers](https://github.com/victor3spoir/boilerplates/tree/main/devcontainers): `devcontainers`

### Delivery templates

- [GitLab CI templates](https://github.com/victor3spoir/boilerplates/tree/main/gitlab): `gitlab`

### Other components

- **Engineer**
- **Project setup**

## Connections

- Engineer → Compose catalog: chooses and adapts
- Engineer → Docker images: chooses and adapts
- Engineer → Kubernetes manifests: chooses and adapts
- Engineer → Ansible automation: chooses and adapts
- Engineer → Cloud bootstrap: chooses and adapts
- Engineer → Terraform/OpenTofu: chooses and adapts
- Engineer → Dev containers: chooses and adapts
- Engineer → GitLab CI templates: chooses and adapts
- Engineer → Databases: chooses and adapts
- Engineer → Brokers: chooses and adapts
- Engineer → Identity: chooses and adapts
- Engineer → Observability: chooses and adapts
- Engineer → Service stacks: chooses and adapts
- Compose catalog → Project setup: copied into
- Docker images → Project setup: adapted for
- Kubernetes manifests → Project setup: adapted for
- Ansible automation → Project setup: adapted for
- Cloud bootstrap → Project setup: adapted for
- Terraform/OpenTofu → Project setup: adapted for
- Dev containers → Project setup: adapted for
- GitLab CI templates → Project setup: adapted for
- Databases → Project setup: adapted for
- Brokers → Project setup: adapted for
- Identity → Project setup: adapted for
- Observability → Project setup: adapted for
- Service stacks → Project setup: adapted for