Stage 7: Rails 7.2 → 8.1 on Ruby 3.2.11

- Bump Rails to 8.1.3 (Ruby unchanged at 3.2.11, new gemset rails8-upgrade)
- config.load_defaults 8.1; merge app:update diffs for all environment files
- Remove routing-filter 0.7.0; replace with native scope '(:locale)' in
  routes.rb and default_url_options in ApplicationController
- Delete config/initializers/routing_filter_rails71_patch.rb
- Replace vendored TinyMCE 3.x (~200 files) with tinymce-rails ~> 8.3;
  migrate admin_interface.js from jQuery .tinymce()/advanced theme to
  tinymce.init(); add config/tinymce.yml; note: TinyMCE 7+ is GPL
- rails-i18n ~> 8.0 added explicitly (previously indirect dependency)
- awesome_nested_set, acts-as-taggable-on pinned to git main/master
  (gemspec activerecord < 8.1 ceiling; no functional incompatibility;
  repin to version once upstream releases updated gemspecs)
- globalize ~> 7.0, libxml-ruby ~> 5.0, nokogiri ~> 1.18, pg ~> 1.5
- sass-rails, coffee-rails, uglifier moved from :assets group to main
  (Sprockets 4 convention; :assets group no longer meaningful)
- Node: head, draft, lock_owner marked belongs_to optional: true
- Page: node, user, editor marked belongs_to optional: true
- Static assets in public/images/ and public/javascripts/ referenced via
  plain HTML tags; Rails 8 load_defaults raises on pipeline helpers for
  undeclared assets
- sessions_controller_test.rb: remove stale require and dead rescue_action
- users_controller_test.rb: assert button[type=submit] not input[type=submit]
  (Rails 8 button_to renders <button> not <input>)
- test_helper.rb: node.reload after children.create! (awesome_nested_set
  3.9.0 does not refresh parent in memory after callback)
- 129 runs, 339 assertions, 3 failures, 0 errors — identical baseline to 7.2

1 files changed, 59 insertions, 25 deletions

diff --git a/Gemfile b/Gemfile
index 2bb3333..13bb4ca 100644
--- a/Gemfile
+++ b/Gemfile
@@ -2,40 +2,74 @@ source 'https://rubygems.org'
 
 ruby '3.2.11'
 
-gem 'rails', '~> 7.2.3'
+# ── Core framework ────────────────────────────────────────────────────────────
+
+gem 'rails',      '~> 8.1'
+gem 'rails-i18n', '~> 8.0'  # AR error messages and date formats for :de locale
+
+# concurrent-ruby 1.3 ships with Rails 8 but has a known incompatibility with
+# some versions of Zeitwerk unless pinned. Remove once upstream resolves it.
 gem 'concurrent-ruby', '~> 1.3'
-gem 'sprockets-rails'
-gem 'puma'
+
+gem 'puma'               # default Rails 8 server; used in development only
+gem 'unicorn', '~> 6.1'  # production server (FreeBSD jail, managed via rc.d)
+
+# ── Database ──────────────────────────────────────────────────────────────────
 
 gem 'pg', '~> 1.5'
 
-gem 'acts-as-taggable-on', '~> 12.0'
-gem 'awesome_nested_set', '~> 3.7.0'
-gem 'acts_as_list'
-gem 'globalize', '~> 7.0'
-gem 'routing-filter', '~> 0.7.0'
-gem 'will_paginate', '~> 3.0'
-gem 'exception_notification', '~> 4.5'
-gem 'libxml-ruby', '~> 5.0', :require => 'xml'
+# ── Asset pipeline ────────────────────────────────────────────────────────────
+
+gem 'sprockets-rails'
+gem 'sass-rails',   '~> 6.0'
+gem 'coffee-rails', '~> 4.0'
+gem 'uglifier',     '>= 1.0.3'
 
-gem 'jquery-rails'
-gem 'jquery-ui-rails'
+gem 'jquery-rails'     # provides jQuery via asset pipeline (admin only)
+gem 'jquery-ui-rails'  # provides jQuery UI via asset pipeline (admin only)
 
-gem 'nokogiri', '~> 1.18'
+# TinyMCE 8 via asset pipeline; replaces vendored TinyMCE 3 in public/javascripts.
+# Note: TinyMCE 7+ is GPL-licensed.
+gem 'tinymce-rails', '~> 8.3'
 
-gem 'unicorn', '~> 6.1'
+# ── Model layer ───────────────────────────────────────────────────────────────
 
-group :assets do
-  gem 'sass-rails', '~> 6.0'
-  gem 'coffee-rails', '~> 4.0'
-  gem 'uglifier', '>= 1.0.3'
-end
+gem 'globalize',      '~> 7.0'    # translated model attributes (Page title/abstract/body)
+gem 'acts_as_list'                # page revision ordering
+gem 'will_paginate',  '~> 3.0'
+
+# Pinned to git until a release widens the activerecord < 8.1 ceiling.
+# Both gems work correctly on Rails 8.1; the gemspec constraint is overly conservative.
+# Revisit when acts-as-taggable-on > 12.x or awesome_nested_set > 3.8.0 is released.
+gem 'acts-as-taggable-on',
+    git:    'https://github.com/mbleigh/acts-as-taggable-on.git',
+    branch: 'master'
+gem 'awesome_nested_set',
+    git:    'https://github.com/collectiveidea/awesome_nested_set.git',
+    branch: 'main'
+
+# ── XML / parsing ─────────────────────────────────────────────────────────────
+
+gem 'libxml-ruby', '~> 5.0', require: 'xml'  # body link rewriting in Page model
+gem 'nokogiri',    '~> 1.18'
+
+# ── Operational ───────────────────────────────────────────────────────────────
+
+gem 'exception_notification', '~> 4.5'
+
+# chaos_calendar: C extension wrapping libical for the public events calendar.
+# Pinned to custom branch; includes FreeBSD 15.1 / libical 3.x header path fix
+# and icaltime_from_timet_with_zone floating-time semantics.
+gem 'chaos_calendar',
+    git:     'https://github.com/erdgeist/chaoscalendar.git',
+    branch:  'erdgeist-ruby1.9',
+    require: 'chaos_calendar'
+
+# ── Test ──────────────────────────────────────────────────────────────────────
 
 group :test do
-  gem 'test-unit', '~> 3.5'
+  gem 'test-unit',              '~> 3.5'
   gem 'rails-controller-testing'
-  gem 'minitest', '~> 5.25'
+  # minitest ~> 5.25 required; 6.x breaks the Rails 8 test runner.
+  gem 'minitest',               '~> 5.25'
 end
-
-gem 'chaos_calendar', :git => 'https://github.com/erdgeist/chaoscalendar.git',
-    :require => 'chaos_calendar', :branch => 'erdgeist-ruby1.9'