rider-kick 0.0.12 → 0.0.13

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 317fad4c5138d788b349d4d58f36a206c4fc66236c2039a64d9cc95df563abde
-  data.tar.gz: 33e079ae9fd531b123ec5d9960e4fa83ff354a8282299e739c2d4f542a27a0c0
+  metadata.gz: c2bc811b644701a52a4afcafd8fb7aa102cd8764cf164da4d1344d135ebd9539
+  data.tar.gz: dfd843914eea99a1df726b882659fed07ffddfd7c13655d5caf12c071252b4ef
 SHA512:
-  metadata.gz: 6f5bff26f5e8fa54319c35237c3f3eaa3105e113068bc661f253218ed574d7f76e7df019e33bd84517e676f7b60857821d506e1e8b15bfffe700e82a68b924e4
-  data.tar.gz: b613c0a8c12fb43ca520a35f4fce2dd3a8fcdbef603f6dd67a8050844ad67a8a101b4658b054b97be8df586b51648e9b322f0f186af09347819bba16f67d8c65
+  metadata.gz: ddf08bea045677b5faae9a9fb8e15efa5f650848e93ec6e97af17cdaa797a50a08edf72e38e88616a28925030cb67688b2e750f7afd488d63c14d4dc9fd350c7
+  data.tar.gz: 6bbeab1d7d099ce51bbf07fabd272e63e31406915d2faa3f744f461ab9238cefc50d707068e3e9c0997ddee8445c088d34133a60ccb10021a53238016ffa1543

data/README.md

@@ -1,15 +1,27 @@
 # RiderKick
+Rails generators for **Clean Architecture** on the backend: use cases, entities, repositories, builders, and utilities — organized for clarity and designed for speed.
+
 This gem provides helper interfaces and classes to assist in the construction of application with
 Clean Architecture, as described in [Robert Martin's seminal book](https://www.amazon.com/gp/product/0134494164).
+---
+## Features
 
+- **Clean Architecture scaffolding**  
+  Creates `app/domains` with `entities/`, `use_cases/`, `repositories/`, `builders/`, and `utils/`.
+- **Use-case-first “screaming architecture”**  
+  Encourages file names like `[role]_[action]_[subject].rb` for immediate intent (e.g., `admin_update_stock.rb`).
+- **Rails-native generators**  
+  Pragmatic commands for bootstrapping domain structure and scaffolding.
+- **Idempotent, minimal friction**  
+  Safe to run more than once; prefers appending or no-ops over destructive changes.
+---
+## ✅ Compatibility
 
-## Installation
-
-Add this line to your application's Gemfile:
+- **Ruby:** ≥ 3.2
+- **Rails:** 7.1, 7.2, 8.0 (up to < 8.1)
 
-```ruby
-gem 'rider-kick'
-```
+---
+## Installation
 
 And then execute:
 ```bash
@@ -26,6 +38,7 @@ And then execute:
 ```bash
     $ bundle add sun-sword
 ```
+---
 ## Usage
 ```bash
 Description:
@@ -39,13 +52,27 @@ Example:
         bin/rails generate rider_kick:scaffold users scope:dashboard
 
 ```
+---
+## Generated Structure
+
+```text
+app/
+  domains/
+    core/
+      entities/
+      builders/
+      repositories/
+      use_cases/
+      utils/
+```
 
+---
 ## Philosophy
 
 The intention of this gem is to help you build applications that are built from the use case down,
 and decisions about I/O can be deferred until the last possible moment.
 
-## Clean Architecture
+### Clean Architecture
 This structure provides helper interfaces and classes to assist in the construction of application with Clean Architecture, as described in Robert Martin's seminal book.
 
 ```
@@ -62,7 +89,7 @@ This structure provides helper interfaces and classes to assist in the construct
         - use_cases (Just Usecase)
         - utils (Class Reusable)
 ```
-## Screaming architecture - use cases as an organisational principle
+### Screaming architecture - use cases as an organisational principle
 Uncle Bob suggests that your source code organisation should allow developers to easily find a listing of all use cases your application provides. Here's an example of how this might look in a this application.
 ```
 - app
@@ -77,6 +104,7 @@ Uncle Bob suggests that your source code organisation should allow developers to
         - retail_customer_makes_deposit.rb
         - ...
 ```
+
 Note that the use case name contains:
 
 - the user role
@@ -88,4 +116,13 @@ Note that the use case name contains:
     # admin_fetch_info.rb [specific usecase]
     # fetch_info.rb [generic usecase] every role can access it
 ```
+---
+## 🤝 Contributing
+
+- Fork the repo & bundle install
+- Create a feature branch: git checkout -b feat/your-feature
+- Add tests where it makes sense
+- ``` bundle exec rspec```
+- Open a Pull Request 🎉
 
+See CONTRIBUTING.md for details.

data/lib/generators/rider_kick/clean_arch_generator.rb

@@ -57,6 +57,7 @@ module RiderKick
       template 'domains/core/entities/pagination.rb.tt', File.join("#{path_app}/domains/core/entities", 'pagination.rb')
 
       template 'domains/core/repositories/abstract_repository.rb.tt', File.join("#{path_app}/domains/core/repositories", 'abstract_repository.rb')
+      template 'domains/core/utils/abstract_utils.rb.tt', File.join("#{path_app}/domains/core/utils", 'abstract_utils.rb')
       template 'domains/core/utils/request_methods.rb.tt', File.join("#{path_app}/domains/core/utils", 'request_methods.rb')
     end
 

data/lib/generators/rider_kick/entity_type_mapping_spec.rb

@@ -0,0 +1,52 @@
+# lib/generators/rider_kick/entity_type_mapping_spec.rb
+# frozen_string_literal: true
+
+require 'rails/generators'
+require 'tmpdir'
+require 'fileutils'
+require 'ostruct'
+require 'generators/rider_kick/scaffold_generator'
+
+RSpec.describe 'entity type mapping' do
+  let(:klass) { RiderKick::ScaffoldGenerator }
+
+  it 'memetakan kolom ke Types::Strict yang benar' do
+    Dir.mktmpdir do |dir|
+      Dir.chdir(dir) do
+        FileUtils.mkdir_p %w[
+          app/domains/core/use_cases
+          app/domains/core/repositories
+          app/domains/core/builders
+          app/domains/core/entities
+          app/models/models
+          db/structures
+        ]
+
+        # pakai stub shared Models::User dari spec/support (sudah auto-require)
+        File.write('app/models/models/user.rb', "class Models::User < ApplicationRecord; end\n")
+        File.write('db/structures/users_structure.yaml', <<~YAML)
+          model: Models::User
+          resource_name: users
+          actor: owner
+          uploaders: []
+          search_able: []
+          domains:
+            action_list:        { use_case: { contract: [] } }
+            action_fetch_by_id: { use_case: { contract: [] } }
+            action_create:      { use_case: { contract: [] } }
+            action_update:      { use_case: { contract: [] } }
+            action_destroy:     { use_case: { contract: [] } }
+          entity: { skipped_fields: [id, created_at, updated_at] }
+        YAML
+
+        klass.new(['users']).generate_use_case
+
+        entity = File.read('app/domains/core/entities/user.rb')
+        # harapannya: string, decimal, datetime dipetakan ke Strict
+        expect(entity).to match(/Types::Strict::String/)
+        expect(entity).to match(/Types::Strict::Decimal|Types::Coercible::Decimal/)
+        expect(entity).to match(/Types::Strict::Time|Types::Strict::Date|Types::Strict::DateTime/)
+      end
+    end
+  end
+end

data/lib/generators/rider_kick/repositories_contract_spec.rb

@@ -0,0 +1,62 @@
+# lib/generators/rider_kick/repositories_contract_spec.rb
+# frozen_string_literal: true
+
+require 'rails/generators'
+require 'tmpdir'
+require 'fileutils'
+require 'ostruct'
+require 'generators/rider_kick/scaffold_generator'
+
+RSpec.describe 'repositories scaffolded content' do
+  let(:klass) { RiderKick::ScaffoldGenerator }
+
+  it 'memuat filter resource_owner + pagination + (opsional) search_able' do
+    Dir.mktmpdir do |dir|
+      Dir.chdir(dir) do
+        FileUtils.mkdir_p %w[
+          app/domains/core/use_cases
+          app/domains/core/repositories
+          app/domains/core/builders
+          app/domains/core/entities
+          app/models/models
+          db/structures
+        ]
+        File.write('app/models/models/user.rb', "class Models::User < ApplicationRecord; end\n")
+        File.write('db/structures/users_structure.yaml', <<~YAML)
+          model: Models::User
+          resource_name: users
+          actor: owner
+          resource_owner_id: owner_id
+          uploaders: []
+          search_able: [name]
+          domains:
+            action_list:        { use_case: { contract: [] } }
+            action_fetch_by_id: { use_case: { contract: [] } }
+            action_create:      { use_case: { contract: [] } }
+            action_update:      { use_case: { contract: [] } }
+            action_destroy:     { use_case: { contract: [] } }
+          entity: { skipped_fields: [id, created_at, updated_at] }
+        YAML
+
+        klass.new(['users']).generate_use_case
+
+        list_repo = File.read('app/domains/core/repositories/users/list_user.rb')
+        expect(list_repo).to match(/resource_owner_id|owner_id|account_id/i) # salah satu pola filter kepemilikan
+        expect(list_repo).to match(/paginate|per_page|page/i)                # pagination hook
+        expect(list_repo).to match(/name|search/i)                           # search_able minimal
+
+        fetch_repo = File.read('app/domains/core/repositories/users/fetch_user_by_id.rb')
+        expect(fetch_repo).to match(/find_by|where\(.+id:/i)
+
+        create_repo = File.read('app/domains/core/repositories/users/create_user.rb')
+        update_repo = File.read('app/domains/core/repositories/users/update_user.rb')
+        destroy_repo = File.read('app/domains/core/repositories/users/destroy_user.rb')
+
+        # repos utama terbentuk & memanggil ActiveRecord target
+        [create_repo, update_repo, destroy_repo].each do |src|
+          expect(src).to include('Models::User')
+        end
+      end
+    end
+  end
+end

data/lib/generators/rider_kick/scaffold_generator_builder_uploaders_spec.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+require 'rails/generators'
+require 'tmpdir'
+require 'active_support/inflector'
+require 'ostruct'
+require 'fileutils'
+require 'generators/rider_kick/scaffold_generator'
+
+RSpec.describe 'rider_kick:scaffold builder (uploaders)' do
+  let(:klass) { RiderKick::ScaffoldGenerator }
+
+  it 'menulis mapping uploader: single (has_one) & multiple (has_many) ke builder' do
+    Dir.mktmpdir do |dir|
+      Dir.chdir(dir) do
+        FileUtils.mkdir_p(%w[
+                            app/domains/core/use_cases
+                            app/domains/core/repositories
+                            app/domains/core/builders
+                            app/domains/core/entities
+                            app/models/models
+                            db/structures
+                          ])
+
+        File.write('app/models/models/user.rb', "class Models::User < ApplicationRecord; end\n")
+
+        # avatar (singular) + images (plural)
+        File.write('db/structures/users_structure.yaml', <<~YAML)
+          model: Models::User
+          resource_name: users
+          actor: owner
+          uploaders: [avatar, images]
+          search_able: []
+          domains:
+            action_list:        { use_case: { contract: [] } }
+            action_fetch_by_id: { use_case: { contract: [] } }
+            action_create:      { use_case: { contract: [] } }
+            action_update:      { use_case: { contract: [] } }
+            action_destroy:     { use_case: { contract: [] } }
+          entity: { skipped_fields: [id, created_at, updated_at] }
+        YAML
+
+        klass.new(['users']).generate_use_case
+
+        builder = File.read('app/domains/core/builders/user.rb')
+        # singular -> satu URL string
+        expect(builder).to include('avatar: (Rails.application.routes.url_helpers.polymorphic_url(params.avatar)')
+        # plural -> array dengan helper build_assets
+        expect(builder).to include('images: build_assets(params.images)')
+        expect(builder).to include('def build_assets(assets)')
+      end
+    end
+  end
+end

data/lib/generators/rider_kick/scaffold_generator_contracts_spec.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+require 'rails/generators'
+require 'tmpdir'
+require 'active_support/inflector'
+require 'ostruct'
+require 'fileutils'
+require 'generators/rider_kick/scaffold_generator'
+
+RSpec.describe 'rider_kick:scaffold contracts' do
+  let(:klass) { RiderKick::ScaffoldGenerator }
+
+  it 'menulis kontrak schema yang tepat di use_cases (list/fetch_by_id/create/update/destroy)' do
+    Dir.mktmpdir do |dir|
+      Dir.chdir(dir) do
+        FileUtils.mkdir_p(%w[
+                            app/domains/core/use_cases
+                            app/domains/core/repositories
+                            app/domains/core/builders
+                            app/domains/core/entities
+                            app/models/models
+                            db/structures
+                          ])
+
+        # Stub model & kolom
+
+        File.write('app/models/models/user.rb', "class Models::User < ApplicationRecord; end\n")
+
+        # YAML struktur minimal
+        File.write('db/structures/users_structure.yaml', <<~YAML)
+          model: Models::User
+          resource_name: users
+          actor: owner
+          uploaders: []
+          search_able: []
+          domains:
+            action_list:        { use_case: { contract: [] } }
+            action_fetch_by_id: { use_case: { contract: [] } }
+            action_create:      { use_case: { contract: [] } }
+            action_update:      { use_case: { contract: [] } }
+            action_destroy:     { use_case: { contract: [] } }
+          entity: { skipped_fields: [id, created_at, updated_at] }
+        YAML
+
+        # Generate
+        klass.new(['users']).generate_use_case
+
+        # Cek isi kontrak
+        readf = ->(path) { File.read(File.join(path)) }
+        base  = 'app/domains/core/use_cases/users'
+
+        expect(readf["#{base}/owner_list_user.rb"])
+          .to include('Core::UseCases::Contract::Default', 'Contract::Pagination')
+
+        expect(readf["#{base}/owner_fetch_user_by_id.rb"])
+          .to include('required(:id).filled(:string)')
+
+        expect(readf["#{base}/owner_create_user.rb"])
+          .to include('Core::Repositories::Users::CreateUser')
+
+        expect(readf["#{base}/owner_update_user.rb"])
+          .to include('required(:id).filled(:string)')
+
+        expect(readf["#{base}/owner_destroy_user.rb"])
+          .to include('required(:id).filled(:string)')
+      end
+    end
+  end
+end

data/lib/generators/rider_kick/scaffold_generator_contracts_with_scope_spec.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+require 'rails/generators'
+require 'tmpdir'
+require 'active_support/inflector'
+require 'ostruct'
+require 'fileutils'
+require 'generators/rider_kick/scaffold_generator'
+
+RSpec.describe 'rider_kick:scaffold contracts (with scope)' do
+  let(:klass) { RiderKick::ScaffoldGenerator }
+
+  it 'menaruh use_cases di folder scope yang benar & menulis kontrak sesuai' do
+    Dir.mktmpdir do |dir|
+      Dir.chdir(dir) do
+        FileUtils.mkdir_p(%w[
+                            app/domains/core/use_cases
+                            app/domains/core/repositories
+                            app/domains/core/builders
+                            app/domains/core/entities
+                            app/models/models
+                            db/structures
+                          ])
+
+        File.write('app/models/models/user.rb', "class Models::User < ApplicationRecord; end\n")
+
+        File.write('db/structures/users_structure.yaml', <<~YAML)
+          model: Models::User
+          resource_name: users
+          actor: owner
+          uploaders: []
+          search_able: []
+          domains:
+            action_list:        { use_case: { contract: [] } }
+            action_fetch_by_id: { use_case: { contract: [] } }
+            action_create:      { use_case: { contract: [] } }
+            action_update:      { use_case: { contract: [] } }
+            action_destroy:     { use_case: { contract: [] } }
+          entity: { skipped_fields: [id, created_at, updated_at] }
+        YAML
+
+        klass.new(['users', 'scope:dashboard']).generate_use_case
+
+        base = 'app/domains/core/use_cases/dashboard/users'
+        %w[owner_list_user owner_fetch_user_by_id owner_create_user owner_update_user owner_destroy_user].each do |uc|
+          expect(File).to exist("#{base}/#{uc}.rb")
+        end
+
+        expect(File.read("#{base}/owner_list_user.rb"))
+          .to include('Core::UseCases::Dashboard::Users::OwnerListUser')
+      end
+    end
+  end
+end

data/lib/generators/rider_kick/scaffold_generator_idempotent_spec.rb

@@ -0,0 +1,59 @@
+# lib/generators/rider_kick/scaffold_generator_idempotent_spec.rb
+# frozen_string_literal: true
+
+require 'rails/generators'
+require 'tmpdir'
+require 'fileutils'
+require 'ostruct'
+require 'generators/rider_kick/scaffold_generator'
+
+RSpec.describe 'rider_kick:scaffold generator (idempotent)' do
+  let(:klass) { RiderKick::ScaffoldGenerator }
+
+  it 'tidak menduplikasi konten ketika dijalankan ulang' do
+    Dir.mktmpdir do |dir|
+      Dir.chdir(dir) do
+        FileUtils.mkdir_p %w[
+          app/domains/core/use_cases
+          app/domains/core/repositories
+          app/domains/core/builders
+          app/domains/core/entities
+          app/models/models
+          db/structures
+        ]
+
+        # model fisik & YAML minimal
+        File.write('app/models/models/user.rb', "class Models::User < ApplicationRecord; end\n")
+        File.write('db/structures/users_structure.yaml', <<~YAML)
+          model: Models::User
+          resource_name: users
+          actor: owner
+          uploaders: []
+          search_able: []
+          domains:
+            action_list:        { use_case: { contract: [] } }
+            action_fetch_by_id: { use_case: { contract: [] } }
+            action_create:      { use_case: { contract: [] } }
+            action_update:      { use_case: { contract: [] } }
+            action_destroy:     { use_case: { contract: [] } }
+          entity: { skipped_fields: [id, created_at, updated_at] }
+        YAML
+
+        # run pertama
+        klass.new(['users']).generate_use_case
+        builder_v1 = File.read('app/domains/core/builders/user.rb')
+
+        # run kedua (seharusnya idempotent)
+        klass.new(['users']).generate_use_case
+        builder_v2 = File.read('app/domains/core/builders/user.rb')
+
+        # konten tidak berubah
+        expect(builder_v2).to eq(builder_v1)
+
+        # entity & repositori tetap 1 file masing-masing
+        expect(Dir['app/domains/core/entities/user.rb'].size).to eq(1)
+        expect(Dir['app/domains/core/repositories/users/*.rb'].size).to be >= 5
+      end
+    end
+  end
+end

data/lib/generators/rider_kick/scaffold_generator_success_spec.rb

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+require 'rails/generators'
+require 'tmpdir'
+require 'active_support/inflector'
+require 'ostruct'
+require 'fileutils'
+require 'generators/rider_kick/scaffold_generator'
+
+RSpec.describe 'rider_kick:scaffold generator (success)' do
+  let(:klass) { RiderKick::ScaffoldGenerator }
+
+  it 'menghasilkan use_cases, repositories, builder, dan entity dari YAML struktur' do
+    Dir.mktmpdir do |dir|
+      Dir.chdir(dir) do
+        # 1) siapkan kerangka clean-arch minimal
+        FileUtils.mkdir_p('app/domains/core/use_cases')
+        FileUtils.mkdir_p('app/domains/core/repositories')
+        FileUtils.mkdir_p('app/domains/core/builders')
+        FileUtils.mkdir_p('app/domains/core/entities')
+        FileUtils.mkdir_p('app/models/models')
+        FileUtils.mkdir_p('db/structures')
+
+        # 2) stub namespace & model + metadata kolom
+
+        # 3) file model untuk inject (hanya dipakai jika uploaders ada)
+        File.write('app/models/models/user.rb', <<~RUBY)
+          class Models::User < ApplicationRecord
+          end
+        RUBY
+
+        # 4) YAML struktur minimal (hasil dari generator :structure pada umumnya)
+        File.write('db/structures/users_structure.yaml', <<~YAML)
+          model: Models::User
+          resource_name: users
+          actor: owner
+          resource_owner_id:
+          uploaders: []
+          search_able: []
+          domains:
+            action_list:
+              use_case:
+                contract: []
+            action_fetch_by_id:
+              use_case:
+                contract: []
+            action_create:
+              use_case:
+                contract: []
+            action_update:
+              use_case:
+                contract: []
+            action_destroy:
+              use_case:
+                contract: []
+          entity:
+            skipped_fields:
+              - id
+              - created_at
+              - updated_at
+        YAML
+
+        # 5) jalankan generator
+        instance = klass.new(['users'])  # arg_structure = "users"
+        instance.generate_use_case
+
+        # 6) verifikasi artefak
+        # use_cases (tanpa route scope): app/domains/core/use_cases/users/<use_case>.rb
+        %w[owner_create_user owner_update_user owner_list_user owner_destroy_user owner_fetch_user_by_id].each do |uc|
+          expect(File).to exist(File.join('app/domains/core/use_cases/users', "#{uc}.rb"))
+        end
+        # repositories: app/domains/core/repositories/users/<repo>.rb
+        %w[create_user update_user list_user destroy_user fetch_user_by_id].each do |repo|
+          expect(File).to exist(File.join('app/domains/core/repositories/users', "#{repo}.rb"))
+        end
+        # builder & entity
+        expect(File).to exist('app/domains/core/builders/user.rb')
+        expect(File).to exist('app/domains/core/entities/user.rb')
+      end
+    end
+  end
+end

data/lib/generators/rider_kick/scaffold_generator_with_scope_spec.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+require 'rails/generators'
+require 'tmpdir'
+require 'active_support/inflector'
+require 'ostruct'
+require 'fileutils'
+require 'generators/rider_kick/scaffold_generator'
+
+RSpec.describe 'rider_kick:scaffold generator (with scope)' do
+  let(:klass) { RiderKick::ScaffoldGenerator }
+
+  it 'meletakkan use_cases di folder route scope yang benar' do
+    Dir.mktmpdir do |dir|
+      Dir.chdir(dir) do
+        FileUtils.mkdir_p('app/domains/core/use_cases')
+        FileUtils.mkdir_p('app/domains/core/repositories')
+        FileUtils.mkdir_p('app/domains/core/builders')
+        FileUtils.mkdir_p('app/domains/core/entities')
+        FileUtils.mkdir_p('app/models/models')
+        FileUtils.mkdir_p('db/structures')
+
+        File.write('app/models/models/user.rb', "class Models::User < ApplicationRecord; end\n")
+
+        File.write('db/structures/users_structure.yaml', <<~YAML)
+          model: Models::User
+          resource_name: users
+          actor: owner
+          uploaders: []
+          search_able: []
+          domains: { action_list: { use_case: { contract: [] } },
+                     action_fetch_by_id: { use_case: { contract: [] } },
+                     action_create: { use_case: { contract: [] } },
+                     action_update: { use_case: { contract: [] } },
+                     action_destroy: { use_case: { contract: [] } } }
+          entity: { skipped_fields: [id, created_at, updated_at] }
+        YAML
+
+        # jalankan dengan token scope:dashboard (Thor hash-arg)
+        instance = klass.new(['users', 'scope:dashboard'])
+        instance.generate_use_case
+
+        # use_cases berada di app/domains/core/use_cases/dashboard/users/...
+        path = 'app/domains/core/use_cases/dashboard/users'
+        %w[owner_create_user owner_update_user owner_list_user owner_destroy_user owner_fetch_user_by_id].each do |uc|
+          expect(File).to exist(File.join(path, "#{uc}.rb"))
+        end
+        # repositories tetap di .../repositories/users
+        %w[create_user update_user list_user destroy_user fetch_user_by_id].each do |repo|
+          expect(File).to exist(File.join('app/domains/core/repositories/users', "#{repo}.rb"))
+        end
+      end
+    end
+  end
+end

data/lib/generators/rider_kick/structure_generator.rb

@@ -30,6 +30,10 @@ module RiderKick
       @uploaders          = uploaders
       @actor              = arg_settings['actor'].downcase
 
+      @resource_owner_id  = arg_settings['resource_owner_id'].to_s.presence
+      @search_able        = arg_settings['search_able'].to_s.split(',').map(&:strip).reject(&:blank?) # => []
+      @columns            = columns_meta # materialize array meta kolom
+
       @type_mapping = {
         'uuid'     => ':string',
         'string'   => ':string',
@@ -55,6 +59,35 @@ module RiderKick
       }
     end
 
+    def columns_meta
+      @model_class.columns.map do |c|
+        {
+          name:      c.name.to_s,
+          type:      c.type,
+          sql_type:  (c.respond_to?(:sql_type) ? c.sql_type : nil),
+          null:      (c.respond_to?(:null) ? c.null : nil),
+          default:   (c.respond_to?(:default) ? c.default : nil),
+          precision: (c.respond_to?(:precision) ? c.precision : nil),
+          scale:     (c.respond_to?(:scale) ? c.scale : nil),
+          limit:     (c.respond_to?(:limit) ? c.limit : nil)
+        }
+      end
+    end
+
+    # optional: isi jika nanti kamu introspeksi foreign keys
+    def fkeys_meta   = []
+
+    # optional: isi jika nanti kamu introspeksi index
+    def indexes_meta = []
+
+    # optional: isi jika pakai AR enum
+    def enums_meta   = {}
+
+    # Kontrak opsional untuk baris dinamis; biarkan kosong dulu agar template aman
+    def contract_lines_for_create = []
+
+    def contract_lines_for_update = []
+
     def is_singular?(str)
       str.singularize == str
     end