super_tools 2.1.0 → 4.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 248f805a4956e73dcc11f4623ebfeb7f124c0d49
-  data.tar.gz: f24028ac4d9d1a4f80f8bd0e5552174fc735f4da
+SHA256:
+  metadata.gz: c307e44d3f7362a213998c9c174923bab9771ff144c67d7a3bbe4271c9533cfe
+  data.tar.gz: 5ad16bfd50ada78a6b6931f54b1cabfa57eb403d9172ee6c2dbd39b437bbc4e5
 SHA512:
-  metadata.gz: 9ec67d9425ff7fa208a0cadd4682eb4a0e1b63dde2eb3e22b9715f679d9a3bd22534b56e65a7f8e792061a8e97686ceccd7f2b78b21afabcfb5e1cacfd93a59d
-  data.tar.gz: 6447defbdd74912a56d187406c3d80e0890b037062c96d06a3d02ac7f6c4074949772321d24ad85b8147908e5def0ff5cdd5340a387c085bd3cabcadaac16847
+  metadata.gz: 04bdb21b6fe4db79fbc9577f3625c5845bc2df314bd798f441c5e3df82928ed75aef392a460a4a576dca7497b078997a41912093ebf79fddada8838db6f0ab8d
+  data.tar.gz: 6de91347858c30e2786ee3e0cc0d4f8425f7be18d2977a7e8aa2bd87841ab456cccf06b9001011692a8d3e5890f865626deb18bfde3737e16ed68680d20f4d9d

data/.github/workflows/test.yml

@@ -0,0 +1,43 @@
+name: Test
+on:
+  push:
+    branches:
+      - 'fix-**'
+      - 'feat-**'
+      - develop
+      - master
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          # Ruby 2.7.6
+          - ruby: '2.7.6'
+            gemfile: gemfiles/ruby_2.7_rails_6.gemfile
+          - ruby: '2.7.6'
+            gemfile: gemfiles/ruby_2.7_rails_7.gemfile
+          # Ruby 3.0.7
+          - ruby: '3.0.7'
+            gemfile: gemfiles/ruby_3.0_rails_6.gemfile
+          - ruby: '3.0.7'
+            gemfile: gemfiles/ruby_3.0_rails_7.gemfile
+          # Ruby 3.1.7
+          - ruby: '3.1.7'
+            gemfile: gemfiles/ruby_3.1_rails_6.gemfile
+          - ruby: '3.1.7'
+            gemfile: gemfiles/ruby_3.1_rails_7.gemfile
+    env:
+      BUNDLE_GEMFILE: ${{ matrix.gemfile }}
+    steps:
+      - uses: actions/checkout@v3
+        with:
+          fetch-depth: 1
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+          bundler-cache: true
+      - run: bundle exec rake t

data/.gitignore

@@ -6,3 +6,9 @@
 /pkg/
 /spec/reports/
 /tmp/
+vendor
+*.*.sw?
+.DS_Store
+db/
+log/
+/gemfiles/*.lock

data/.ruby-version

@@ -0,0 +1 @@
+2.7.6

data/Appraisals

@@ -0,0 +1,29 @@
+# Ruby 2.7.6 with Rails 6
+appraise "ruby-2.7-rails-6" do
+  gem "rails", "~> 6.1.0"
+end
+
+# Ruby 2.7.6 with Rails 7
+appraise "ruby-2.7-rails-7" do
+  gem "rails", "~> 7.0.0"
+end
+
+# Ruby 3.0.7 with Rails 6
+appraise "ruby-3.0-rails-6" do
+  gem "rails", "~> 6.1.0"
+end
+
+# Ruby 3.0.7 with Rails 7
+appraise "ruby-3.0-rails-7" do
+  gem "rails", "~> 7.0.0"
+end
+
+# Ruby 3.1.7 with Rails 6
+appraise "ruby-3.1-rails-6" do
+  gem "rails", "~> 6.1.0"
+end
+
+# Ruby 3.1.7 with Rails 7
+appraise "ruby-3.1-rails-7" do
+  gem "rails", "~> 7.0.0"
+end

data/Gemfile

@@ -4,3 +4,5 @@ git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
 
 # Specify your gem's dependencies in super_tools.gemspec
 gemspec
+
+gem "reform-rails", github: "superlanding/reform-rails", tag: "v0.2.6.f"

data/Gemfile.lock

@@ -1,18 +1,26 @@
+GIT
+  remote: https://github.com/superlanding/reform-rails
+  revision: 9309677a20293133167fe992e9795f367732b08f
+  tag: v0.2.6.f
+  specs:
+    reform-rails (0.2.6)
+      activemodel (>= 5.0)
+      reform (>= 2.3.1, < 3.0.0)
+
 PATH
   remote: .
   specs:
-    super_tools (0.0.8)
-      dry-logic (~> 0.4.2)
-      dry-types (~> 0.13.2)
+    super_tools (3.0.0)
+      dry-logic (= 1.2.0)
+      dry-types (= 1.5.1)
       fast_excel
       forwardable
-      iconv
-      nokogiri (>= 1.6, <= 1.9.1)
-      rails (>= 4)
-      reform (~> 2.2.4)
+      nokogiri (>= 1.6)
+      rails (>= 6.1, < 8)
+      reform (= 2.6.2)
       reform-rails
       roo
-      roo-xls
+      roo-xls (= 1.2.0)
       searchkick
       spreadsheet
       virtus (~> 1.0.5)
@@ -21,194 +29,195 @@ PATH
 GEM
   remote: https://rubygems.org/
   specs:
-    actioncable (5.2.3)
-      actionpack (= 5.2.3)
+    actioncable (6.1.6)
+      actionpack (= 6.1.6)
+      activesupport (= 6.1.6)
       nio4r (~> 2.0)
       websocket-driver (>= 0.6.1)
-    actionmailer (5.2.3)
-      actionpack (= 5.2.3)
-      actionview (= 5.2.3)
-      activejob (= 5.2.3)
+    actionmailbox (6.1.6)
+      actionpack (= 6.1.6)
+      activejob (= 6.1.6)
+      activerecord (= 6.1.6)
+      activestorage (= 6.1.6)
+      activesupport (= 6.1.6)
+      mail (>= 2.7.1)
+    actionmailer (6.1.6)
+      actionpack (= 6.1.6)
+      actionview (= 6.1.6)
+      activejob (= 6.1.6)
+      activesupport (= 6.1.6)
       mail (~> 2.5, >= 2.5.4)
       rails-dom-testing (~> 2.0)
-    actionpack (5.2.3)
-      actionview (= 5.2.3)
-      activesupport (= 5.2.3)
-      rack (~> 2.0)
+    actionpack (6.1.6)
+      actionview (= 6.1.6)
+      activesupport (= 6.1.6)
+      rack (~> 2.0, >= 2.0.9)
       rack-test (>= 0.6.3)
       rails-dom-testing (~> 2.0)
-      rails-html-sanitizer (~> 1.0, >= 1.0.2)
-    actionview (5.2.3)
-      activesupport (= 5.2.3)
+      rails-html-sanitizer (~> 1.0, >= 1.2.0)
+    actiontext (6.1.6)
+      actionpack (= 6.1.6)
+      activerecord (= 6.1.6)
+      activestorage (= 6.1.6)
+      activesupport (= 6.1.6)
+      nokogiri (>= 1.8.5)
+    actionview (6.1.6)
+      activesupport (= 6.1.6)
       builder (~> 3.1)
       erubi (~> 1.4)
       rails-dom-testing (~> 2.0)
-      rails-html-sanitizer (~> 1.0, >= 1.0.3)
-    activejob (5.2.3)
-      activesupport (= 5.2.3)
+      rails-html-sanitizer (~> 1.1, >= 1.2.0)
+    activejob (6.1.6)
+      activesupport (= 6.1.6)
       globalid (>= 0.3.6)
-    activemodel (5.2.3)
-      activesupport (= 5.2.3)
-    activerecord (5.2.3)
-      activemodel (= 5.2.3)
-      activesupport (= 5.2.3)
-      arel (>= 9.0)
-    activestorage (5.2.3)
-      actionpack (= 5.2.3)
-      activerecord (= 5.2.3)
-      marcel (~> 0.3.1)
-    activesupport (5.2.3)
+    activemodel (6.1.6)
+      activesupport (= 6.1.6)
+    activerecord (6.1.6)
+      activemodel (= 6.1.6)
+      activesupport (= 6.1.6)
+    activestorage (6.1.6)
+      actionpack (= 6.1.6)
+      activejob (= 6.1.6)
+      activerecord (= 6.1.6)
+      activesupport (= 6.1.6)
+      marcel (~> 1.0)
+      mini_mime (>= 1.1.0)
+    activesupport (6.1.6)
       concurrent-ruby (~> 1.0, >= 1.0.2)
-      i18n (>= 0.7, < 2)
-      minitest (~> 5.1)
-      tzinfo (~> 1.1)
-    arel (9.0.0)
+      i18n (>= 1.6, < 2)
+      minitest (>= 5.1)
+      tzinfo (~> 2.0)
+      zeitwerk (~> 2.3)
+    appraisal (2.5.0)
+      bundler
+      rake
+      thor (>= 0.14.0)
     axiom-types (0.1.1)
       descendants_tracker (~> 0.0.4)
       ice_nine (~> 0.11.0)
       thread_safe (~> 0.3, >= 0.3.1)
-    builder (3.2.3)
+    builder (3.2.4)
     coercible (1.0.0)
       descendants_tracker (~> 0.0.1)
-    concurrent-ruby (1.1.5)
-    crass (1.0.4)
-    declarative (0.0.10)
-    declarative-builder (0.1.0)
-      declarative-option (< 0.2.0)
-    declarative-option (0.1.0)
+    concurrent-ruby (1.3.6)
+    crass (1.0.6)
+    declarative (0.0.20)
     descendants_tracker (0.0.4)
       thread_safe (~> 0.3, >= 0.3.1)
-    disposable (0.4.5)
+    disposable (0.6.3)
       declarative (>= 0.0.9, < 1.0.0)
-      declarative-builder (< 0.2.0)
-      declarative-option (< 0.2.0)
-      representable (>= 2.4.0, <= 3.1.0)
-      uber (< 0.2.0)
-    dry-configurable (0.7.0)
+      representable (>= 3.1.1, < 4)
+    dry-configurable (0.15.0)
       concurrent-ruby (~> 1.0)
-    dry-container (0.6.0)
+      dry-core (~> 0.6)
+    dry-container (0.9.0)
       concurrent-ruby (~> 1.0)
-      dry-configurable (~> 0.1, >= 0.1.3)
-    dry-core (0.4.7)
+      dry-configurable (~> 0.13, >= 0.13.0)
+    dry-core (0.7.1)
       concurrent-ruby (~> 1.0)
-    dry-equalizer (0.2.2)
-    dry-inflector (0.1.2)
-    dry-logic (0.4.2)
-      dry-container (~> 0.2, >= 0.2.6)
-      dry-core (~> 0.2)
-      dry-equalizer (~> 0.2)
-    dry-types (0.13.4)
+    dry-inflector (0.2.1)
+    dry-logic (1.2.0)
+      concurrent-ruby (~> 1.0)
+      dry-core (~> 0.5, >= 0.5)
+    dry-types (1.5.1)
       concurrent-ruby (~> 1.0)
       dry-container (~> 0.3)
-      dry-core (~> 0.4, >= 0.4.4)
-      dry-equalizer (~> 0.2)
+      dry-core (~> 0.5, >= 0.5)
       dry-inflector (~> 0.1, >= 0.1.2)
-      dry-logic (~> 0.4, >= 0.4.2)
-    elasticsearch (7.0.0)
-      elasticsearch-api (= 7.0.0)
-      elasticsearch-transport (= 7.0.0)
-    elasticsearch-api (7.0.0)
-      multi_json
-    elasticsearch-transport (7.0.0)
-      faraday
-      multi_json
+      dry-logic (~> 1.0, >= 1.0.2)
     equalizer (0.0.11)
-    erubi (1.8.0)
-    faraday (0.15.4)
-      multipart-post (>= 1.2, < 3)
-    fast_excel (0.2.6)
+    erubi (1.10.0)
+    fast_excel (0.4.0)
       ffi (> 1.9, < 2)
-    ffi (1.10.0)
-    forwardable (1.2.0)
-    globalid (0.4.2)
-      activesupport (>= 4.2.0)
-    hashie (3.6.0)
-    i18n (1.5.1)
+    ffi (1.15.5)
+    forwardable (1.3.2)
+    globalid (1.0.0)
+      activesupport (>= 5.0)
+    hashie (5.0.0)
+    i18n (1.14.8)
       concurrent-ruby (~> 1.0)
     ice_nine (0.11.2)
-    iconv (1.0.8)
-    loofah (2.2.3)
+    loofah (2.18.0)
       crass (~> 1.0.2)
       nokogiri (>= 1.5.9)
     mail (2.7.1)
       mini_mime (>= 0.1.1)
-    marcel (0.3.3)
-      mimemagic (~> 0.3.2)
-    method_source (0.9.2)
-    mimemagic (0.3.3)
-    mini_mime (1.0.1)
-    mini_portile2 (2.4.0)
-    minitest (5.11.3)
-    multi_json (1.13.1)
-    multipart-post (2.0.0)
-    nio4r (2.3.1)
-    nokogiri (1.9.1)
-      mini_portile2 (~> 2.4.0)
-    rack (2.0.8)
-    rack-test (1.1.0)
-      rack (>= 1.0, < 3)
-    rails (5.2.3)
-      actioncable (= 5.2.3)
-      actionmailer (= 5.2.3)
-      actionpack (= 5.2.3)
-      actionview (= 5.2.3)
-      activejob (= 5.2.3)
-      activemodel (= 5.2.3)
-      activerecord (= 5.2.3)
-      activestorage (= 5.2.3)
-      activesupport (= 5.2.3)
-      bundler (>= 1.3.0)
-      railties (= 5.2.3)
+    marcel (1.0.2)
+    method_source (1.0.0)
+    mini_mime (1.1.2)
+    minitest (5.26.1)
+    nio4r (2.5.8)
+    nokogiri (1.13.6-arm64-darwin)
+      racc (~> 1.4)
+    nokogiri (1.13.6-x86_64-linux)
+      racc (~> 1.4)
+    racc (1.6.0)
+    rack (2.2.4)
+    rack-test (2.0.2)
+      rack (>= 1.3)
+    rails (6.1.6)
+      actioncable (= 6.1.6)
+      actionmailbox (= 6.1.6)
+      actionmailer (= 6.1.6)
+      actionpack (= 6.1.6)
+      actiontext (= 6.1.6)
+      actionview (= 6.1.6)
+      activejob (= 6.1.6)
+      activemodel (= 6.1.6)
+      activerecord (= 6.1.6)
+      activestorage (= 6.1.6)
+      activesupport (= 6.1.6)
+      bundler (>= 1.15.0)
+      railties (= 6.1.6)
       sprockets-rails (>= 2.0.0)
     rails-dom-testing (2.0.3)
       activesupport (>= 4.2.0)
       nokogiri (>= 1.6)
-    rails-html-sanitizer (1.0.4)
-      loofah (~> 2.2, >= 2.2.2)
-    railties (5.2.3)
-      actionpack (= 5.2.3)
-      activesupport (= 5.2.3)
+    rails-html-sanitizer (1.4.3)
+      loofah (~> 2.3)
+    railties (6.1.6)
+      actionpack (= 6.1.6)
+      activesupport (= 6.1.6)
       method_source
-      rake (>= 0.8.7)
-      thor (>= 0.19.0, < 2.0)
-    rake (10.5.0)
-    reform (2.2.4)
-      disposable (>= 0.4.1)
-      representable (>= 2.4.0, < 3.1.0)
-    reform-rails (0.1.7)
-      activemodel (>= 3.2)
-      reform (>= 2.2.0)
-    representable (3.0.4)
+      rake (>= 12.2)
+      thor (~> 1.0)
+    rake (13.0.6)
+    reform (2.6.2)
+      disposable (>= 0.5.0, < 1.0.0)
+      representable (>= 3.1.1, < 4)
+      uber (< 0.2.0)
+    representable (3.2.0)
       declarative (< 0.1.0)
-      declarative-option (< 0.2.0)
+      trailblazer-option (>= 0.1.1, < 0.2.0)
       uber (< 0.2.0)
-    roo (2.7.1)
+    roo (2.9.0)
       nokogiri (~> 1)
-      rubyzip (~> 1.1, < 2.0.0)
+      rubyzip (>= 1.3.0, < 3.0.0)
     roo-xls (1.2.0)
       nokogiri
       roo (>= 2.0.0, < 3)
       spreadsheet (> 0.9.0)
     ruby-ole (1.2.12.2)
-    rubyzip (1.2.2)
-    searchkick (3.1.3)
-      activemodel (>= 4.2)
-      elasticsearch (>= 5)
+    rubyzip (2.3.2)
+    searchkick (5.0.4)
+      activemodel (>= 5.2)
       hashie
-    shoulda-context (1.2.2)
-    spreadsheet (1.2.3)
-      ruby-ole (>= 1.0)
-    sprockets (3.7.2)
+    shoulda-context (2.0.0)
+    spreadsheet (1.3.0)
+      ruby-ole
+    sprockets (4.1.1)
       concurrent-ruby (~> 1.0)
       rack (> 1, < 3)
-    sprockets-rails (3.2.1)
-      actionpack (>= 4.0)
-      activesupport (>= 4.0)
+    sprockets-rails (3.4.2)
+      actionpack (>= 5.2)
+      activesupport (>= 5.2)
       sprockets (>= 3.0.0)
-    thor (0.20.3)
+    sqlite3 (1.4.4)
+    thor (1.2.1)
     thread_safe (0.3.6)
-    tzinfo (1.2.5)
-      thread_safe (~> 0.1)
+    trailblazer-option (0.1.2)
+    tzinfo (2.0.6)
+      concurrent-ruby (~> 1.0)
     uber (0.1.0)
     virtus (1.0.5)
       axiom-types (~> 0.1)
@@ -217,19 +226,26 @@ GEM
       equalizer (~> 0.0, >= 0.0.9)
     warehouse_items (0.3.0)
       activesupport
-    websocket-driver (0.7.0)
+    warning (1.2.1)
+    websocket-driver (0.7.5)
       websocket-extensions (>= 0.1.0)
-    websocket-extensions (0.1.3)
+    websocket-extensions (0.1.5)
+    zeitwerk (2.6.18)
 
 PLATFORMS
-  ruby
+  arm64-darwin-21
+  x86_64-linux
 
 DEPENDENCIES
-  bundler (~> 1.16)
+  appraisal
+  bundler (>= 2, < 3)
   minitest (~> 5.0)
-  rake (~> 10.0)
+  rake (>= 12.2)
+  reform-rails!
   shoulda-context
+  sqlite3 (= 1.4.4)
   super_tools!
+  warning
 
 BUNDLED WITH
-   1.17.1
+   2.3.14

data/MULTI_RUBY_TESTING.md

@@ -0,0 +1,170 @@
+# Multi-Ruby Version Testing Guide
+
+本專案已設定支援多個 Ruby 版本（2.7.6, 3.0.7, 3.1.7）與 Rails 版本（6.x, 7.x）的測試環境。
+
+## 支援的版本組合
+
+### Ruby 版本
+- **Ruby 2.7.6**
+- **Ruby 3.0.7**
+- **Ruby 3.1.7**
+
+### Rails 版本
+- **Rails 6.1.x**
+- **Rails 7.0.x**
+
+### 測試矩陣（共 6 個組合）
+1. Ruby 2.7.6 + Rails 6.1
+2. Ruby 2.7.6 + Rails 7.0
+3. Ruby 3.0.7 + Rails 6.1
+4. Ruby 3.0.7 + Rails 7.0
+5. Ruby 3.1.7 + Rails 6.1
+6. Ruby 3.1.7 + Rails 7.0
+
+## 專案結構
+
+```
+.
+├── Appraisals                           # Appraisal 設定檔
+├── gemfiles/                            # 各版本組合的 Gemfile
+│   ├── ruby_2.7_rails_6.gemfile
+│   ├── ruby_2.7_rails_7.gemfile
+│   ├── ruby_3.0_rails_6.gemfile
+│   ├── ruby_3.0_rails_7.gemfile
+│   ├── ruby_3.1_rails_6.gemfile
+│   └── ruby_3.1_rails_7.gemfile
+├── bin/test_all                         # 本地測試所有版本的腳本
+└── .github/workflows/test.yml           # GitHub Actions 設定
+```
+
+## 本地測試
+
+### 測試所有組合
+
+```bash
+bin/test_all
+```
+
+此腳本會依序測試所有 6 個 Ruby + Rails 版本組合。
+
+### 測試特定組合
+
+```bash
+# Ruby 2.7.6 + Rails 6
+bundle exec appraisal ruby-2.7-rails-6 rake t
+
+# Ruby 2.7.6 + Rails 7
+bundle exec appraisal ruby-2.7-rails-7 rake t
+
+# Ruby 3.0.7 + Rails 6
+bundle exec appraisal ruby-3.0-rails-6 rake t
+
+# Ruby 3.0.7 + Rails 7
+bundle exec appraisal ruby-3.0-rails-7 rake t
+
+# Ruby 3.1.7 + Rails 6
+bundle exec appraisal ruby-3.1-rails-6 rake t
+
+# Ruby 3.1.7 + Rails 7
+bundle exec appraisal ruby-3.1-rails-7 rake t
+```
+
+### 安裝所有版本的依賴
+
+```bash
+bundle install
+bundle exec appraisal install
+```
+
+## GitHub Actions
+
+當你推送程式碼到以下分支時，GitHub Actions 會自動測試所有版本組合：
+- `fix-**`
+- `feat-**`
+- `develop`
+- `master`
+- Pull Requests
+
+測試矩陣會執行所有 6 個 Ruby + Rails 版本組合測試。
+
+### CI 配置
+
+GitHub Actions 使用明確的版本號：
+- Ruby: `2.7.6`, `3.0.7`, `3.1.7`
+- Rails: `~> 6.1.0`, `~> 7.0.0`
+
+## 依賴套件相容性
+
+所有主要依賴套件都支援 Ruby 2.7+ 和 Rails 6/7：
+
+### 核心依賴
+- **Rails** - 支援 6.1.x 和 7.0.x
+- **nokogiri** >= 1.6 - 支援 Ruby 2.7+
+- **fast_excel** - 支援 Ruby 2.5+
+- **roo** - 支援 Ruby 2.5+
+- **dry-types** 1.5.1 - 支援 Ruby 2.7+
+- **dry-logic** 1.2.0 - 支援 Ruby 2.7+
+- **reform** 2.6.2 - 支援 Ruby 2.5+
+- **reform-rails** - 支援 Rails 6/7
+- **searchkick** - 支援 Ruby 2.6+
+- **virtus** ~> 1.0.5 - 支援 Ruby 2.7+
+
+### Rails 7 特定依賴
+Rails 7 會自動引入以下額外依賴：
+- `benchmark`
+- `drb`
+- `mutex_m`
+- `securerandom`
+
+## 更新依賴
+
+當你需要更新 gemfiles 時：
+
+```bash
+# 編輯 Appraisals 檔案
+# 然後重新生成 gemfiles
+bundle exec appraisal install
+```
+
+如需更新某個特定組合的依賴：
+
+```bash
+bundle exec appraisal ruby-3.1-rails-7 bundle update
+```
+
+## 開發建議
+
+1. **本地開發環境**：建議使用 Ruby 2.7.6 作為預設開發版本（見 `.ruby-version`）
+
+2. **提交前測試**：在提交 PR 前，建議至少測試以下組合：
+   - 最低版本：Ruby 2.7.6 + Rails 6.1
+   - 最高版本：Ruby 3.1.7 + Rails 7.0
+
+3. **新增依賴**：確保新增的依賴套件都支援：
+   - Ruby >= 2.7.0
+   - Rails >= 6.1, < 8
+
+## 注意事項
+
+- `gemfiles/*.lock` 檔案已加入 `.gitignore`，不會被 commit
+- `gemfiles/*.gemfile` 檔案會被 commit，確保 CI/CD 環境一致性
+- gemspec 中 Rails 版本範圍設定為 `">= 6.1", "< 8"`，支援 Rails 6 和 7
+- 確保新增的依賴套件都支援 Ruby 2.7+ 和 Rails 6/7
+
+## 疑難排解
+
+### 問題：bundle install 失敗
+
+```bash
+# 清理並重新安裝
+rm -rf gemfiles/.bundle
+bundle exec appraisal install
+```
+
+### 問題：某個組合測試失敗
+
+```bash
+# 重新安裝該組合的依賴
+bundle exec appraisal ruby-3.1-rails-7 bundle install
+bundle exec appraisal ruby-3.1-rails-7 rake t
+```