# bancolombia/scaffold-clean-architecture architecture

> Architecture diagram of the GitHub repository bancolombia/scaffold-clean-architecture, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bancolombia/scaffold-clean-architecture
- Repository: https://github.com/bancolombia/scaffold-clean-architecture

## Overview

This repository is a Gradle plugin for scaffolding Java applications that follow Clean Architecture. The main workflow is a developer invoking a generation task, which resolves a generator and uses module-building/template logic to create project files. The tree also shows generators for entry points, driven adapters, pipelines, and upgrades, plus validation and Gradle conventions. Evidence is limited: only selected source excerpts and SOURCE INDEX references were supplied, so uncertain dispatch relationships are shown as unverified rather than asserted.

Main entry points: [`src/main/java/co/com/bancolombia/factory/ModuleBuilder.java`](https://github.com/bancolombia/scaffold-clean-architecture/blob/master/src/main/java/co/com/bancolombia/factory/ModuleBuilder.java) (Module builder), [`src/main/java/co/com/bancolombia/task`](https://github.com/bancolombia/scaffold-clean-architecture/tree/master/src/main/java/co/com/bancolombia/task) (Generation tasks), [`src/main/java/co/com/bancolombia/factory/pipelines`](https://github.com/bancolombia/scaffold-clean-architecture/tree/master/src/main/java/co/com/bancolombia/factory/pipelines) (Pipeline generators), [`src/main/java/co/com/bancolombia/factory/ModuleFactory.java`](https://github.com/bancolombia/scaffold-clean-architecture/blob/master/src/main/java/co/com/bancolombia/factory/ModuleFactory.java) (Module factory)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_plugin["Plugin entry"]
  node_plugin["Gradle plugin<br/>[PluginClean.java]"]
  node_tasks["Generation tasks"]
  node_abstract_task["Task base"]
  node_resolver["Type resolver"]
end

subgraph group_generation["Project generation"]
  node_builder["Module builder<br/>[ModuleBuilder.java]"]
  node_factory["Module factory<br/>[ModuleFactory.java]"]
  node_entrypoints["Entry generators"]
  node_adapters["Adapter generators"]
  node_pipelines["Pipeline generators"]
  node_helpers["Shared generators"]
end

subgraph group_extensions["Generated options"]
  node_validations["Architecture validation"]
  node_conventions["Gradle conventions"]
end

subgraph group_maintenance["Project maintenance"]
  node_upgrades["Upgrade actions"]
  node_models["Scaffold models"]
end

node_developer(("Developer"))
node_generated_project["Generated application"]

node_developer -.->|"invokes"| node_plugin
node_plugin -.->|"registers"| node_tasks
node_tasks -->|"extends"| node_abstract_task
node_tasks -->|"extends"| node_resolver
node_resolver -->|"resolves"| node_pipelines
node_pipelines -->|"implements"| node_factory
node_pipelines -->|"configures"| node_builder
node_tasks -.->|"prepares"| node_builder
node_builder -->|"writes files"| node_generated_project
node_entrypoints -.->|"implements"| node_factory
node_adapters -.->|"implements"| node_factory
node_helpers -.->|"supports"| node_builder
node_validations -.->|"validates"| node_builder
node_conventions -.->|"configures"| node_generated_project
node_upgrades -.->|"updates"| node_builder
node_models -.->|"provides data"| node_builder

click node_plugin "https://github.com/bancolombia/scaffold-clean-architecture/blob/master/src/main/java/co/com/bancolombia/PluginClean.java"
click node_tasks "https://github.com/bancolombia/scaffold-clean-architecture/tree/master/src/main/java/co/com/bancolombia/task"
click node_abstract_task "https://github.com/bancolombia/scaffold-clean-architecture/blob/master/src/main/java/co/com/bancolombia/task/AbstractCleanArchitectureDefaultTask.java"
click node_resolver "https://github.com/bancolombia/scaffold-clean-architecture/blob/master/src/main/java/co/com/bancolombia/task/AbstractResolvableTypeTask.java"
click node_builder "https://github.com/bancolombia/scaffold-clean-architecture/blob/master/src/main/java/co/com/bancolombia/factory/ModuleBuilder.java"
click node_factory "https://github.com/bancolombia/scaffold-clean-architecture/blob/master/src/main/java/co/com/bancolombia/factory/ModuleFactory.java"
click node_entrypoints "https://github.com/bancolombia/scaffold-clean-architecture/tree/master/src/main/java/co/com/bancolombia/factory/entrypoints"
click node_adapters "https://github.com/bancolombia/scaffold-clean-architecture/tree/master/src/main/java/co/com/bancolombia/factory/adapters"
click node_pipelines "https://github.com/bancolombia/scaffold-clean-architecture/tree/master/src/main/java/co/com/bancolombia/factory/pipelines"
click node_helpers "https://github.com/bancolombia/scaffold-clean-architecture/tree/master/src/main/java/co/com/bancolombia/factory/commons"
click node_validations "https://github.com/bancolombia/scaffold-clean-architecture/tree/master/src/main/java/co/com/bancolombia/factory/validations"
click node_conventions "https://github.com/bancolombia/scaffold-clean-architecture/tree/master/src/main/java/co/com/bancolombia/plugins"
click node_upgrades "https://github.com/bancolombia/scaffold-clean-architecture/tree/master/src/main/java/co/com/bancolombia/factory/upgrades"
click node_models "https://github.com/bancolombia/scaffold-clean-architecture/tree/master/src/main/java/co/com/bancolombia/models"

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_plugin,node_tasks,node_abstract_task,node_resolver toneBlue
class node_builder,node_factory,node_entrypoints,node_adapters,node_pipelines,node_helpers toneAmber
class node_validations,node_conventions toneMint
class node_upgrades,node_models toneRose
class node_developer,node_generated_project toneIndigo
```

## Components

### Plugin entry

- [Gradle plugin](https://github.com/bancolombia/scaffold-clean-architecture/blob/master/src/main/java/co/com/bancolombia/PluginClean.java): `src/main/java/co/com/bancolombia/PluginClean.java`
- [Generation tasks](https://github.com/bancolombia/scaffold-clean-architecture/tree/master/src/main/java/co/com/bancolombia/task): `src/main/java/co/com/bancolombia/task`
- [Task base](https://github.com/bancolombia/scaffold-clean-architecture/blob/master/src/main/java/co/com/bancolombia/task/AbstractCleanArchitectureDefaultTask.java): `src/main/java/co/com/bancolombia/task/AbstractCleanArchitectureDefaultTask.java`
- [Type resolver](https://github.com/bancolombia/scaffold-clean-architecture/blob/master/src/main/java/co/com/bancolombia/task/AbstractResolvableTypeTask.java): `src/main/java/co/com/bancolombia/task/AbstractResolvableTypeTask.java`

### Project generation

- [Module builder](https://github.com/bancolombia/scaffold-clean-architecture/blob/master/src/main/java/co/com/bancolombia/factory/ModuleBuilder.java): `src/main/java/co/com/bancolombia/factory/ModuleBuilder.java`
- [Module factory](https://github.com/bancolombia/scaffold-clean-architecture/blob/master/src/main/java/co/com/bancolombia/factory/ModuleFactory.java): `src/main/java/co/com/bancolombia/factory/ModuleFactory.java`
- [Entry generators](https://github.com/bancolombia/scaffold-clean-architecture/tree/master/src/main/java/co/com/bancolombia/factory/entrypoints): `src/main/java/co/com/bancolombia/factory/entrypoints`
- [Adapter generators](https://github.com/bancolombia/scaffold-clean-architecture/tree/master/src/main/java/co/com/bancolombia/factory/adapters): `src/main/java/co/com/bancolombia/factory/adapters`
- [Pipeline generators](https://github.com/bancolombia/scaffold-clean-architecture/tree/master/src/main/java/co/com/bancolombia/factory/pipelines): `src/main/java/co/com/bancolombia/factory/pipelines`
- [Shared generators](https://github.com/bancolombia/scaffold-clean-architecture/tree/master/src/main/java/co/com/bancolombia/factory/commons): `src/main/java/co/com/bancolombia/factory/commons`

### Generated options

- [Architecture validation](https://github.com/bancolombia/scaffold-clean-architecture/tree/master/src/main/java/co/com/bancolombia/factory/validations): `src/main/java/co/com/bancolombia/factory/validations`
- [Gradle conventions](https://github.com/bancolombia/scaffold-clean-architecture/tree/master/src/main/java/co/com/bancolombia/plugins): `src/main/java/co/com/bancolombia/plugins`

### Project maintenance

- [Upgrade actions](https://github.com/bancolombia/scaffold-clean-architecture/tree/master/src/main/java/co/com/bancolombia/factory/upgrades): `src/main/java/co/com/bancolombia/factory/upgrades`
- [Scaffold models](https://github.com/bancolombia/scaffold-clean-architecture/tree/master/src/main/java/co/com/bancolombia/models): `src/main/java/co/com/bancolombia/models`

### Other components

- **Developer**
- **Generated application**

## Connections

- Developer → Gradle plugin: invokes (evidence: `README.md`)
- Gradle plugin → Generation tasks: registers
- Generation tasks → Task base: extends (evidence: `src/main/java/co/com/bancolombia/task/GeneratePipelineTask.java`)
- Generation tasks → Type resolver: extends (evidence: `src/main/java/co/com/bancolombia/task/GeneratePipelineTask.java`)
- Type resolver → Pipeline generators: resolves
- Pipeline generators → Module factory: implements (evidence: `src/main/java/co/com/bancolombia/factory/pipelines/PipelineCircleCI.java`)
- Pipeline generators → Module builder: configures (evidence: `src/main/java/co/com/bancolombia/factory/pipelines/PipelineCircleCI.java`)
- Generation tasks → Module builder: prepares (evidence: `src/main/java/co/com/bancolombia/factory/ModuleBuilder.java`)
- Module builder → Generated application: writes files (evidence: `src/main/java/co/com/bancolombia/factory/ModuleBuilder.java`)
- Entry generators → Module factory: implements
- Adapter generators → Module factory: implements
- Shared generators → Module builder: supports
- Architecture validation → Module builder: validates (evidence: `src/main/java/co/com/bancolombia/factory/ModuleBuilder.java`)
- Gradle conventions → Generated application: configures
- Upgrade actions → Module builder: updates
- Scaffold models → Module builder: provides data (evidence: `src/main/java/co/com/bancolombia/factory/ModuleBuilder.java`)
