Replace Enzyme snapshot tests with React Testing Library (RTL) behavioral tests in Foreman plugin projects. Use when converting snapshot tests for React 18 migration.

2026-04-283

investigate-bug

ianballou/cosmic-unconscious

Systematic approach to investigating software bugs

2026-04-203

ruby-rails

ianballou/cosmic-unconscious

Ruby on Rails conventions and patterns for Foreman ecosystem projects

2026-04-173

katello-testing

ianballou/cosmic-unconscious

Katello test patterns, factories, and conventions

2026-04-173

code-explorer

ianballou/cosmic-unconscious

How to navigate and explain unfamiliar codebases effectively

2026-04-173

name	foreman-architecture
description	Foreman codebase architecture and plugin system

Foreman Architecture

Plugin System

Plugins are Rails Engines registered in bundler.d/
Katello: bundler.d/katello.local.rb
Plugins extend models via concerns and facets
Host facets: app/models/host/ — plugins add facets for their domain

Core Domains

Hosts: Host::Managed, Host::Base — central model
Smart Proxies: SmartProxy — remote execution, content, DHCP, DNS, etc.
RBAC: Permission, Role, Filter — used by all plugins including Katello
Compute Resources: VM provisioning integrations
Config Management: Puppet, Ansible (via plugins)

Code Flow: API Request

Request hits app/controllers/api/v2/
Authorized via RBAC (before_action :find_resource, :authorize)
Rendered via RABL views or jbuilder

Key for Katello Developers

Foreman's RBAC system is what Katello's permissions build on
Host::Managed is extended by Katello via ContentFacet
Smart proxy infrastructure is how Katello manages capsule content

Gotchas

(Add entries as discovered)