plutonium 0.43.2 → 0.44.0

data/lib/generators/pu/saas/setup/USAGE

@@ -1,27 +1,22 @@
 Description:
-    Generate a complete SaaS setup with user account, entity, and membership.
-    This is the recommended way to set up multi-tenant authentication.
+    Generate a complete SaaS setup with user account, entity, membership,
+    portal, welcome flow, invites, and profile.
+
+    This is the recommended way to bootstrap a multi-tenant SaaS app.
 
 Example:
-    rails g pu:saas:setup --user Customer --entity Organization
-    rails g pu:saas:setup --user Customer --entity Organization --roles=member,admin,owner
-    rails g pu:saas:setup --user Customer --entity Organization --no-allow-signup
-    rails g pu:saas:setup --user Customer --entity Organization --user-attributes=name:string
-    rails g pu:saas:setup --user Customer --entity Organization --skip-entity
+    rails g pu:saas:setup --user=User --entity=Organization
 
-    This creates:
-        1. User account (Customer) with Rodauth authentication
-        2. Entity model (Organization) with unique name
-        3. Membership model (OrganizationCustomer) with role enum
+    Full setup with all defaults:
+      - User model with Rodauth authentication
+      - Entity model with unique name and dynamic path parameter
+      - Membership model with owner/admin/member roles
+      - DashboardPortal with entity scoping
+      - Welcome/onboarding flow
+      - User invites package
+      - User profile resource
 
-Options:
-    --user                      User model name (required)
-    --entity                    Entity model name (required)
-    --allow-signup              Allow public registration (default: true)
-    --roles                     Comma-separated membership roles (default: member,owner)
-    --skip-entity               Skip entity model generation
-    --skip-membership           Skip membership model generation
-    --user-attributes           Additional user model attributes
-    --entity-attributes         Additional entity model attributes
-    --membership-attributes     Additional membership model attributes
-    --dest                      Destination package (default: main_app)
+    Customize:
+    rails g pu:saas:setup --user=User --entity=Organization --portal-name=Customer
+    rails g pu:saas:setup --user=User --entity=Organization --no-invites --no-profile
+    rails g pu:saas:setup --user=User --entity=Organization --no-portal

data/lib/generators/pu/saas/setup_generator.rb

@@ -8,10 +8,10 @@ module Pu
     class SetupGenerator < ::Rails::Generators::Base
       include PlutoniumGenerators::Generator
 
-      desc "Generate a complete SaaS setup with user, entity, and membership"
+      desc "Generate a complete SaaS setup with user, entity, membership, portal, and welcome flow"
 
       class_option :user, type: :string, required: true,
-        desc: "The user model name (e.g., Customer)"
+        desc: "The user model name (e.g., User)"
 
       class_option :entity, type: :string, required: true,
         desc: "The entity model name (e.g., Organization)"
@@ -19,8 +19,8 @@ module Pu
       class_option :allow_signup, type: :boolean, default: true,
         desc: "Whether to allow users to sign up to the platform"
 
-      class_option :roles, type: :array, default: %w[member owner],
-        desc: "Available roles for memberships"
+      class_option :roles, type: :array, default: %w[admin member],
+        desc: "Additional roles for memberships (owner is always included as the first role)"
 
       class_option :skip_entity, type: :boolean, default: false,
         desc: "Skip entity model generation"
@@ -37,6 +37,21 @@ module Pu
       class_option :membership_attributes, type: :array, default: [],
         desc: "Additional attributes for the membership model"
 
+      class_option :portal, type: :boolean, default: true,
+        desc: "Generate a portal with entity scoping"
+
+      class_option :portal_name, type: :string, default: "Dashboard",
+        desc: "Portal name (e.g., Dashboard generates DashboardPortal)"
+
+      class_option :welcome, type: :boolean, default: true,
+        desc: "Generate the welcome/onboarding flow"
+
+      class_option :invites, type: :boolean, default: true,
+        desc: "Generate the user invites package"
+
+      class_option :profile, type: :boolean, default: true,
+        desc: "Generate user profile resource"
+
       class_option :api_client, type: :string, default: nil,
         desc: "Generate an API client model (e.g., ApiClient)"
 
@@ -48,6 +63,10 @@ module Pu
         generate_user
         generate_entity unless options[:skip_entity]
         generate_membership unless options[:skip_membership]
+        generate_portal if options[:portal] && !options[:skip_entity]
+        generate_profile if options[:profile]
+        generate_welcome if options[:welcome] && !options[:skip_entity] && options[:portal]
+        generate_invites if options[:invites] && !options[:skip_entity] && !options[:skip_membership]
         generate_api_client if options[:api_client].present?
       rescue => e
         exception "#{self.class} failed:", e
@@ -62,7 +81,6 @@ module Pu
       end
 
       def generate_user
-        # Use class-based invocation to avoid Thor's invoke caching
         klass = Rails::Generators.find_by_namespace("pu:saas:user")
         klass.new(
           [options[:user]],
@@ -76,7 +94,6 @@ module Pu
       end
 
       def generate_entity
-        # Use class-based invocation to avoid Thor's invoke caching
         klass = Rails::Generators.find_by_namespace("pu:saas:entity")
         klass.new(
           [options[:entity]],
@@ -90,7 +107,6 @@ module Pu
       end
 
       def generate_membership
-        # Use class-based invocation to avoid Thor's invoke caching
         klass = Rails::Generators.find_by_namespace("pu:saas:membership")
         klass.new(
           [],
@@ -106,8 +122,34 @@ module Pu
         ).invoke_all
       end
 
+      def generate_portal
+        generate "pu:saas:portal",
+          "--entity-model=#{options[:entity]} --user-model=#{options[:user]}" \
+          " --portal-name=#{options[:portal_name]}" \
+          " --rodauth=#{rodauth_config}"
+      end
+
+      def generate_profile
+        generate "pu:profile:setup",
+          "--user-model=#{options[:user]} --dest=main_app" \
+          "#{" --portal=#{portal_package}" if options[:portal]}"
+      end
+
+      def generate_welcome
+        generate "pu:saas:welcome",
+          "--user-model=#{options[:user]} --entity-model=#{options[:entity]}" \
+          " --portal=#{portal_engine}" \
+          " --rodauth=#{rodauth_config}" \
+          "#{" --profile" if options[:profile]}"
+      end
+
+      def generate_invites
+        generate "pu:invites:install",
+          "--entity-model=#{options[:entity]} --user-model=#{options[:user]} --dest=main_app" \
+          " --rodauth=#{rodauth_config}"
+      end
+
       def generate_api_client
-        # Use class-based invocation to avoid Thor's invoke caching
         klass = Rails::Generators.find_by_namespace("pu:saas:api_client")
         api_client_options = {
           roles: options[:api_client_roles],
@@ -116,11 +158,22 @@ module Pu
           skip: options[:skip]
         }
 
-        # Scope to entity if entity is being generated
         api_client_options[:entity] = options[:entity] unless options[:skip_entity]
 
         klass.new([options[:api_client]], api_client_options).invoke_all
       end
+
+      def rodauth_config
+        options[:user].underscore
+      end
+
+      def portal_package
+        "#{options[:portal_name].underscore}_portal"
+      end
+
+      def portal_engine
+        "#{options[:portal_name].camelize}Portal"
+      end
     end
   end
 end

data/lib/generators/pu/saas/welcome/USAGE

@@ -0,0 +1,27 @@
+Description:
+  Generates a post-login welcome flow with onboarding and entity selection.
+
+  This creates the controllers, views, and routes needed to bridge
+  authentication and the main portal:
+
+  - AuthenticatedController: base controller requiring login
+  - WelcomeController: routing hub (invite check -> onboarding -> entity selection -> portal)
+  - Onboarding view: create first entity (and optional profile)
+  - Entity selection view: choose from multiple entities
+
+Example:
+  rails g pu:saas:welcome --user-model=User --entity-model=Organization --portal=CustomerPortal
+
+  This generates:
+    app/controllers/authenticated_controller.rb
+    app/controllers/welcome_controller.rb
+    app/views/welcome/onboarding.html.erb
+    app/views/welcome/select_entity.html.erb
+
+  And adds routes:
+    GET  /welcome         -> welcome#index
+    GET  /welcome/onboard -> welcome#new_entity
+    POST /welcome/onboard -> welcome#onboard
+
+Options:
+  --profile  Include profile setup in onboarding form

data/lib/generators/pu/saas/welcome/templates/app/controllers/authenticated_controller.rb.tt

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+class AuthenticatedController < ApplicationController
+<% if rodauth? -%>
+  include Plutonium::Auth::Rodauth(:<%= rodauth_config %>)
+
+  before_action { rodauth.require_authentication }
+<% else -%>
+  before_action :require_authenticated
+
+  private
+
+  def require_authenticated
+    # TODO: Implement based on your authentication system
+    redirect_to "/login" unless current_user
+  end
+<% end -%>
+end

data/lib/generators/pu/saas/welcome/templates/app/controllers/welcome_controller.rb.tt

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+class WelcomeController < AuthenticatedController
+  layout "welcome"
+
+  def index
+    entities = current_user.<%= entity_table.pluralize %>.to_a
+    if entities.none?
+      @<%= entity_table %> = <%= entity_model %>.new
+<% if profile? -%>
+      @profile = current_user.profile || current_user.build_profile
+<% end -%>
+      render :onboarding
+    elsif entities.one?
+      redirect_to portal_root_path(entities.first)
+    else
+      @entities = entities
+      render :select_entity
+    end
+  end
+
+  def new_entity
+    @<%= entity_table %> = <%= entity_model %>.new
+<% if profile? -%>
+    @profile = current_user.profile || current_user.build_profile
+<% end -%>
+    render :onboarding
+  end
+
+  def onboard
+    @<%= entity_table %> = <%= entity_model %>.new(<%= entity_table %>_params)
+<% if profile? -%>
+    @profile = current_user.profile || current_user.build_profile
+    @profile.assign_attributes(profile_params)
+
+    if @<%= entity_table %>.valid? && @profile.valid?
+<% else -%>
+    if @<%= entity_table %>.valid?
+<% end -%>
+      ActiveRecord::Base.transaction do
+        @<%= entity_table %>.save!
+        <%= membership_model %>.create!(<%= entity_table %>: @<%= entity_table %>, <%= user_table %>: current_user, role: :owner)
+<% if profile? -%>
+        @profile.save!
+<% end -%>
+      end
+      redirect_to portal_root_path(@<%= entity_table %>), notice: "Welcome! Your workspace is ready."
+    else
+      render :onboarding, status: :unprocessable_entity
+    end
+  end
+
+  private
+
+  def <%= entity_table %>_params
+    params.require(:<%= entity_table %>).permit(:name)
+  end
+<% if profile? -%>
+
+  def profile_params
+    params.require(:profile).permit(:name)
+  end
+<% end -%>
+
+  def portal_root_path(<%= entity_table %>)
+    <%= portal_engine %>::Engine.routes.url_helpers.<%= entity_table %>_root_path(<%= entity_table %>: <%= entity_table %>)
+  end
+  helper_method :portal_root_path
+end

data/lib/generators/pu/saas/welcome/templates/app/views/layouts/welcome.html.erb.tt

@@ -0,0 +1,33 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>Welcome</title>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width,initial-scale=1">
+  <meta name="csrf-param" content="authenticity_token" />
+  <meta name="csrf-token" content="<%%= form_authenticity_token %>" />
+  <%%= stylesheet_link_tag "application", "data-turbo-track": "reload" %>
+  <%%= javascript_importmap_tags %>
+</head>
+<body class="antialiased min-h-screen bg-[var(--pu-body)]">
+  <main class="p-4 min-h-screen flex flex-col items-center justify-center gap-2 px-6 py-8 mx-auto lg:py-0">
+    <%% if flash.any? %>
+      <%% flash.each do |type, message| %>
+        <div class="fixed z-50 top-16 inset-x-0 mx-auto flex items-center w-full max-w-md p-4 rounded-[var(--pu-radius-lg)]"
+             style="box-shadow: var(--pu-shadow-md); background: <%%= type == 'alert' ? 'var(--color-danger-50)' : 'var(--color-success-50)' %>; color: <%%= type == 'alert' ? 'var(--color-danger-600)' : 'var(--color-success-600)' %>"
+             role="alert">
+          <div class="ms-3 text-sm font-normal"><%%= message %></div>
+        </div>
+      <%% end %>
+    <%% end %>
+
+    <!-- Main content card -->
+    <div class="w-full sm:max-w-md bg-[var(--pu-card-bg)] border border-[var(--pu-card-border)] rounded-[var(--pu-radius-lg)]"
+         style="box-shadow: var(--pu-shadow-lg)">
+      <div class="p-6 space-y-4 md:space-y-6 sm:p-8">
+        <%%= yield %>
+      </div>
+    </div>
+  </main>
+</body>
+</html>

data/lib/generators/pu/saas/welcome/templates/app/views/welcome/onboarding.html.erb.tt

@@ -0,0 +1,51 @@
+<h1 class="text-lg font-bold leading-tight tracking-tight text-[var(--pu-text)] md:text-xl text-center">
+  Welcome! Let's get you set up.
+</h1>
+
+<%%= form_with(url: welcome_onboard_path, method: :post, class: "space-y-4 md:space-y-6") do |f| %>
+<% if profile? -%>
+  <%% if @<%= entity_table %>.errors.any? || @profile.errors.any? %>
+<% else -%>
+  <%% if @<%= entity_table %>.errors.any? %>
+<% end -%>
+    <div class="p-4 rounded-[var(--pu-radius-lg)] bg-[color:var(--color-danger-50)] text-[color:var(--color-danger-600)]">
+      <ul class="list-disc list-inside text-sm">
+        <%% @<%= entity_table %>.errors.full_messages.each do |message| %>
+          <li><%%= message %></li>
+        <%% end %>
+<% if profile? -%>
+        <%% @profile.errors.full_messages.each do |message| %>
+          <li><%%= message %></li>
+        <%% end %>
+<% end -%>
+      </ul>
+    </div>
+  <%% end %>
+<% if profile? -%>
+
+  <%%= f.fields_for :profile, @profile do |pf| %>
+    <div>
+      <%%= pf.label :name, "Your Name", class: "block mb-2 text-sm font-medium text-[var(--pu-text)]" %>
+      <%%= pf.text_field :name,
+          class: "pu-input w-full",
+          placeholder: "e.g. Jane Smith",
+          autofocus: true %>
+    </div>
+  <%% end %>
+<% end -%>
+
+  <%%= f.fields_for :<%= entity_table %>, @<%= entity_table %> do |ef| %>
+    <div>
+      <%%= ef.label :name, "Workspace Name", class: "block mb-2 text-sm font-medium text-[var(--pu-text)]" %>
+      <%%= ef.text_field :name,
+          class: "pu-input w-full",
+          placeholder: "e.g. Acme Corp",
+<% unless profile? -%>
+          autofocus: true,
+<% end -%>
+          required: true %>
+    </div>
+  <%% end %>
+
+  <%%= f.submit "Get Started", class: "w-full pu-btn pu-btn-md pu-btn-primary" %>
+<%% end %>

data/lib/generators/pu/saas/welcome/templates/app/views/welcome/select_entity.html.erb.tt

@@ -0,0 +1,22 @@
+<h1 class="text-lg font-bold leading-tight tracking-tight text-[var(--pu-text)] md:text-xl text-center">
+  Select a Workspace
+</h1>
+
+<div class="space-y-2">
+  <%% @entities.each do |<%= entity_table %>| %>
+    <a href="<%%= portal_root_path(<%= entity_table %>) %>"
+       class="flex items-center gap-3 w-full p-4 text-left bg-[var(--pu-surface-alt)] border border-[var(--pu-border)] rounded-[var(--pu-radius-lg)] hover:border-[var(--color-primary-500)] hover:bg-[var(--pu-surface)] transition-colors">
+      <div class="flex-1">
+        <p class="font-medium text-[var(--pu-text)]"><%%= <%= entity_table %>.name %></p>
+      </div>
+      <%%= render Phlex::TablerIcons::ChevronRight.new(class: "w-5 h-5 text-[var(--pu-text-muted)]") %>
+    </a>
+  <%% end %>
+</div>
+
+<div class="pt-2">
+  <a href="<%%= welcome_onboard_path %>"
+     class="w-full block pu-btn pu-btn-md pu-btn-outline text-center">
+    Create New Workspace
+  </a>
+</div>

data/lib/generators/pu/saas/welcome_generator.rb

@@ -0,0 +1,197 @@
+# frozen_string_literal: true
+
+require "rails/generators/base"
+require_relative "../lib/plutonium_generators"
+
+module Pu
+  module Saas
+    class WelcomeGenerator < ::Rails::Generators::Base
+      include PlutoniumGenerators::Generator
+      include PlutoniumGenerators::Concerns::RodauthRedirects
+
+      source_root File.expand_path("welcome/templates", __dir__)
+
+      desc "Generate a post-login welcome flow with onboarding and entity selection"
+
+      class_option :user_model, type: :string, required: true,
+        desc: "The user model name (e.g., User)"
+
+      class_option :entity_model, type: :string, required: true,
+        desc: "The entity model name (e.g., Organization)"
+
+      class_option :portal, type: :string, required: true,
+        desc: "The portal engine name (e.g., CustomerPortal)"
+
+      class_option :membership_model, type: :string,
+        desc: "The membership model name (defaults to <Entity><User>)"
+
+      class_option :rodauth, type: :string, default: "user",
+        desc: "Rodauth configuration name"
+
+      class_option :profile, type: :boolean, default: false,
+        desc: "Include profile setup in onboarding"
+
+      def start
+        validate_requirements
+        create_authenticated_controller
+        create_welcome_controller
+        create_views
+        add_routes
+        configure_rodauth
+        show_instructions
+      rescue => e
+        exception "#{self.class} failed:", e
+      end
+
+      private
+
+      def validate_requirements
+        errors = []
+
+        unless File.exist?(user_model_path)
+          errors << "User model not found: #{user_model_path.relative_path_from(Rails.root)}"
+        end
+
+        unless File.exist?(entity_model_path)
+          errors << "Entity model not found: #{entity_model_path.relative_path_from(Rails.root)}"
+        end
+
+        if File.exist?(user_model_path)
+          user_content = File.read(user_model_path)
+          unless user_content.include?("has_many :#{entity_table.pluralize}")
+            errors << "User model missing 'has_many :#{entity_table.pluralize}' — run the membership generator first"
+          end
+        end
+
+        if errors.any?
+          errors.each { |e| say_status :error, e, :red }
+          raise Thor::Error, "Required files missing:\n  - #{errors.join("\n  - ")}"
+        end
+      end
+
+      def create_authenticated_controller
+        template "app/controllers/authenticated_controller.rb",
+          "app/controllers/authenticated_controller.rb"
+      end
+
+      def create_welcome_controller
+        template "app/controllers/welcome_controller.rb",
+          "app/controllers/welcome_controller.rb"
+      end
+
+      def create_views
+        template "app/views/layouts/welcome.html.erb",
+          "app/views/layouts/welcome.html.erb"
+
+        template "app/views/welcome/select_entity.html.erb",
+          "app/views/welcome/select_entity.html.erb"
+
+        template "app/views/welcome/onboarding.html.erb",
+          "app/views/welcome/onboarding.html.erb"
+      end
+
+      def add_routes
+        routes_file = "config/routes.rb"
+        routes_content = File.read(Rails.root.join(routes_file))
+
+        if routes_content.include?("# Welcome & onboarding")
+          say_status :skip, "Welcome routes already present", :yellow
+          return
+        end
+
+        route_code = <<-RUBY
+
+  # Welcome & onboarding
+  get "welcome", to: "welcome#index"
+  get "welcome/onboard", to: "welcome#new_entity", as: :welcome_onboard
+  post "welcome/onboard", to: "welcome#onboard"
+        RUBY
+
+        # Remove the standalone invites welcome route if it exists,
+        # since the main WelcomeController now handles /welcome
+        if routes_content.include?('get "welcome", to: "invites/welcome#index"')
+          gsub_file routes_file,
+            /\n\s*# Welcome route \(handled by invites.*\n\s*get "welcome", to: "invites\/welcome#index"\n/,
+            "\n"
+        end
+
+        inject_into_file routes_file,
+          route_code,
+          before: /^end\s*\z/
+      end
+
+      def configure_rodauth
+        return unless rodauth?
+
+        update_rodauth_redirects("app/rodauth/#{rodauth_config}_rodauth_plugin.rb")
+      end
+
+      def show_instructions
+        say "\n"
+        say "=" * 79
+        say "\n"
+        say "Welcome flow installed successfully!"
+        say "\n"
+        say "Next steps:"
+        say "\n"
+        say "1. Run migrations (if you haven't already):"
+        say "   rails db:migrate"
+        say "\n"
+        say "2. Customize the onboarding view to match your app:"
+        say "   app/views/welcome/onboarding.html.erb"
+        say "\n"
+        if profile?
+          say "3. Ensure your User model has a `profile` association:"
+          say "   has_one :profile"
+          say "\n"
+        end
+        say "=" * 79
+        say "\n"
+      end
+
+      def user_model
+        options[:user_model].camelize
+      end
+
+      def user_table
+        options[:user_model].underscore
+      end
+
+      def entity_model
+        options[:entity_model].camelize
+      end
+
+      def entity_table
+        options[:entity_model].underscore
+      end
+
+      def portal_engine
+        options[:portal].camelize
+      end
+
+      def membership_model
+        options[:membership_model] || "#{entity_model}#{user_model}"
+      end
+
+      def rodauth_config
+        options[:rodauth]
+      end
+
+      def rodauth?
+        rodauth_config.present?
+      end
+
+      def profile?
+        options[:profile]
+      end
+
+      def entity_model_path
+        Rails.root.join("app/models/#{entity_table}.rb")
+      end
+
+      def user_model_path
+        Rails.root.join("app/models/#{user_table}.rb")
+      end
+    end
+  end
+end

data/lib/plutonium/auth/sequel_adapter.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require "sequel/core"
-
 module Plutonium
   module Auth
     # Provides runtime detection of the database adapter for Sequel configuration.
@@ -26,6 +24,7 @@ module Plutonium
         # @return [Sequel::Database] configured Sequel database connection
         # @raise [RuntimeError] if the Sequel adapter initialization fails
         def db
+          require "sequel/core"
           adapter = sequel_adapter
           begin
             if RUBY_ENGINE == "jruby"

data/lib/plutonium/core/controller.rb

@@ -145,7 +145,10 @@ module Plutonium
         end
 
         # Build the named helper: e.g., "blogging_post_nested_post_metadata_path"
-        parent_singular = parent.model_name.singular
+        # For plural parent resources (resources :posts), nested routes use the singular member name (post_nested_...)
+        # For singular parent resources (resource :entities), nested routes use the route name as-is (entities_nested_...)
+        parent_is_singular_route = current_engine.routes.singular_resource_route?(parent.model_name.plural)
+        parent_prefix = parent_is_singular_route ? parent.model_name.plural : parent.model_name.singular
         nested_resource_name = "#{prefix}#{association_name}"
 
         # Determine if this is a collection action (no specific record)
@@ -158,12 +161,10 @@ module Plutonium
         #   - :new action uses singular (new_blogging_post_nested_comment)
         #   - member actions (show/edit/update/destroy) use singular (blogging_post_nested_comment)
         is_collection_action = action == :index || action == :create || (no_record && action != :new)
-        helper_base = if is_singular
-          "#{parent_singular}_#{nested_resource_name}"
-        elsif is_collection_action
-          "#{parent_singular}_#{nested_resource_name}"
+        helper_base = if is_singular || is_collection_action
+          "#{parent_prefix}_#{nested_resource_name}"
         else
-          "#{parent_singular}_#{nested_resource_name.to_s.singularize}"
+          "#{parent_prefix}_#{nested_resource_name.to_s.singularize}"
         end
 
         # Only add helper prefix for actions that have named route helpers (new, edit)
@@ -173,10 +174,19 @@ module Plutonium
         else "#{action}_"
         end
 
-        helper_name = :"#{helper_suffix}#{helper_base}_path"
+        # Add entity scope prefix for path-based entity scoping
+        entity_prefix = if scoped_to_entity? && scoped_entity_strategy == :path
+          "#{scoped_entity_param_key}_"
+        end
+
+        helper_name = :"#{helper_suffix}#{entity_prefix}#{helper_base}_path"
 
         # Build the arguments for the helper
-        helper_args = [parent.to_param]
+        helper_args = []
+        # Add entity scope param for path-based entity scoping
+        helper_args << current_scoped_entity.to_param if entity_prefix
+        # Singular parent resources (resource :entity) have no :id param in the route
+        helper_args << parent.to_param unless parent_is_singular_route
         # Include element ID for plural routes (has_many) when we have a record instance
         # Skip ID for collection actions (:index, :create) which don't need a member ID
         unless is_singular || no_record || is_collection_action