# james2m/seedbank architecture

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

- Interactive diagram: https://gitdiagram.com/james2m/seedbank
- Repository: https://github.com/james2m/seedbank

## Overview

Seedbank organizes application seed scripts into Rake tasks, then evaluates them in a shared runner. The main workflow is task loading, seed discovery and task creation, dependency-ordered execution, and Ruby seed evaluation in the application environment. README-documented capabilities include common and environment-specific task scopes, preserving the original db/seeds.rb task, and seed dependencies. Source excerpts show the DSL and runner; task-file wiring and some task relationships are documented but not sampled.

Main entry points: [`lib/seedbank/dsl.rb`](https://github.com/james2m/seedbank/blob/master/lib/seedbank/dsl.rb) (Common and environment tasks), [`lib/seedbank/runner.rb`](https://github.com/james2m/seedbank/blob/master/lib/seedbank/runner.rb) (Seed runner), [`lib/tasks/seed.rake`](https://github.com/james2m/seedbank/blob/master/lib/tasks/seed.rake) (Task integration), [`lib/seedbank/railtie.rb`](https://github.com/james2m/seedbank/blob/master/lib/seedbank/railtie.rb) (Rails task hook)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_integration["Rake and Rails integration"]
  node_task_entry["Task integration<br/>[seed.rake]"]
  node_railtie["Rails task hook<br/>[railtie.rb]"]
  node_seedbank["Seedbank setup<br/>[seedbank.rb]"]
end

subgraph group_tasks["Seed task generation"]
  node_dsl["Seed task DSL<br/>[dsl.rb]"]
  node_task_scopes["Common and environment tasks<br/>[dsl.rb]"]
  node_original_seed["Original seed task<br/>[dsl.rb]"]
end

subgraph group_execution["Seed execution"]
  node_runner["Seed runner<br/>[runner.rb]"]
  node_dependency_order["Seed dependencies<br/>[runner.rb]"]
  node_memo_helpers["Memoized helpers<br/>[runner.rb]"]
end

node_operator(("Application operator"))
node_rake["Rake task runner"]
node_rails["Rails environment"]
node_seed_scripts["Seed scripts"]
node_database[("Application database")]

node_operator -->|"invokes tasks"| node_rake
node_rake -->|"loads seed tasks"| node_task_entry
node_seedbank -->|"loads when Rails"| node_railtie
node_railtie -->|"loads tasks"| node_task_entry
node_task_entry -.->|"configures task DSL"| node_dsl
node_dsl -->|"discovers files"| node_seed_scripts
node_dsl -->|"creates scoped tasks"| node_task_scopes
node_task_scopes -->|"evaluates seed file"| node_runner
node_task_entry -->|"preserves original task"| node_original_seed
node_original_seed -->|"runs as dependency"| node_rake
node_rake -->|"invokes selected task"| node_task_scopes
node_task_scopes -->|"requires environment"| node_rails
node_runner -->|"invokes prerequisites"| node_dependency_order
node_dependency_order -->|"dispatches seed tasks"| node_task_scopes
node_runner -->|"provides helpers"| node_memo_helpers
node_runner -->|"executes seed Ruby"| node_database

click node_task_entry "https://github.com/james2m/seedbank/blob/master/lib/tasks/seed.rake"
click node_railtie "https://github.com/james2m/seedbank/blob/master/lib/seedbank/railtie.rb"
click node_seedbank "https://github.com/james2m/seedbank/blob/master/lib/seedbank.rb"
click node_dsl "https://github.com/james2m/seedbank/blob/master/lib/seedbank/dsl.rb"
click node_task_scopes "https://github.com/james2m/seedbank/blob/master/lib/seedbank/dsl.rb"
click node_original_seed "https://github.com/james2m/seedbank/blob/master/lib/seedbank/dsl.rb"
click node_runner "https://github.com/james2m/seedbank/blob/master/lib/seedbank/runner.rb"
click node_dependency_order "https://github.com/james2m/seedbank/blob/master/lib/seedbank/runner.rb"
click node_memo_helpers "https://github.com/james2m/seedbank/blob/master/lib/seedbank/runner.rb"

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_task_entry,node_railtie,node_seedbank toneBlue
class node_dsl,node_task_scopes,node_original_seed,node_database toneAmber
class node_runner,node_dependency_order,node_memo_helpers toneMint
class node_operator,node_rails,node_seed_scripts toneIndigo
class node_rake toneRose
```

## Components

### Rake and Rails integration

- [Task integration](https://github.com/james2m/seedbank/blob/master/lib/tasks/seed.rake): `lib/tasks/seed.rake`
- [Rails task hook](https://github.com/james2m/seedbank/blob/master/lib/seedbank/railtie.rb): `lib/seedbank/railtie.rb`
- [Seedbank setup](https://github.com/james2m/seedbank/blob/master/lib/seedbank.rb): `lib/seedbank.rb`

### Seed task generation

- [Seed task DSL](https://github.com/james2m/seedbank/blob/master/lib/seedbank/dsl.rb): `lib/seedbank/dsl.rb`
- [Common and environment tasks](https://github.com/james2m/seedbank/blob/master/lib/seedbank/dsl.rb): `lib/seedbank/dsl.rb`
- [Original seed task](https://github.com/james2m/seedbank/blob/master/lib/seedbank/dsl.rb): `lib/seedbank/dsl.rb`

### Seed execution

- [Seed runner](https://github.com/james2m/seedbank/blob/master/lib/seedbank/runner.rb): `lib/seedbank/runner.rb`
- [Seed dependencies](https://github.com/james2m/seedbank/blob/master/lib/seedbank/runner.rb): `lib/seedbank/runner.rb`
- [Memoized helpers](https://github.com/james2m/seedbank/blob/master/lib/seedbank/runner.rb): `lib/seedbank/runner.rb`

### Other components

- **Application operator**
- **Rake task runner**
- **Rails environment**
- **Seed scripts**
- **Application database**

## Connections

- Application operator → Rake task runner: invokes tasks (evidence: `README.md`)
- Rake task runner → Task integration: loads seed tasks (evidence: `README.md`)
- Seedbank setup → Rails task hook: loads when Rails (evidence: `lib/seedbank.rb`)
- Rails task hook → Task integration: loads tasks (evidence: `README.md`)
- Task integration → Seed task DSL: configures task DSL
- Seed task DSL → Seed scripts: discovers files (evidence: `lib/seedbank/dsl.rb`)
- Seed task DSL → Common and environment tasks: creates scoped tasks (evidence: `lib/seedbank/dsl.rb`)
- Common and environment tasks → Seed runner: evaluates seed file (evidence: `lib/seedbank/dsl.rb`)
- Task integration → Original seed task: preserves original task (evidence: `README.md`)
- Original seed task → Rake task runner: runs as dependency (evidence: `README.md`)
- Rake task runner → Common and environment tasks: invokes selected task (evidence: `README.md`)
- Common and environment tasks → Rails environment: requires environment (evidence: `lib/seedbank/dsl.rb`)
- Seed runner → Seed dependencies: invokes prerequisites (evidence: `lib/seedbank/runner.rb`)
- Seed dependencies → Common and environment tasks: dispatches seed tasks (evidence: `lib/seedbank/runner.rb`)
- Seed runner → Memoized helpers: provides helpers (evidence: `lib/seedbank/runner.rb`)
- Seed runner → Application database: executes seed Ruby (evidence: `README.md`)
