Architecture: pal-enterprises Rails App

arch-rails-app-pal-enterprises Architecture

architecture active

Project

Architecture: pal-enterprises Rails App

Single Rails 8.1 app serving the platform front door.

Components

PagesController -- public landing page at /
ContactsController -- stateless contact form, delivers via Action Mailer
SessionsController -- Keycloak OIDC login/logout/callback
DashboardController -- authenticated tool grid, session-gated

Auth Flow

Deployment

Key Decisions

No local user table -- Keycloak sub/name/email stored in session only
Contact form is stateless -- email delivery, no DB persistence
omniauth-openid-connect gem for OIDC
Tailwind CSS, Hotwire (Turbo + Stimulus)

project-pal-enterprises -- project page
sop-keycloak-client-creation -- SOP for registering the OIDC client
arch-deployment-pal-enterprises -- deployment architecture (TBD)