smart_domain 0.1.0

data/lib/smart_domain/tasks/domains.rake

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+namespace :active_domain do
+  desc "List all registered domains"
+  task domains: :environment do
+    setup_files = Dir[Rails.root.join("app/domains/**/setup.rb")]
+
+    if setup_files.empty?
+      puts "No domains found in app/domains/"
+      puts "Generate your first domain with: rails generate active_domain:domain User"
+    else
+      puts "Registered domains:"
+      setup_files.each do |setup_file|
+        domain_path = setup_file.gsub(Rails.root.join("app/domains/").to_s, "")
+        domain_name = domain_path.split("/").first
+        puts "  - #{domain_name}"
+      end
+      puts "\nTotal: #{setup_files.size} domain(s)"
+    end
+  end
+
+  desc "Reload all domain setups"
+  task reload: :environment do
+    setup_files = Dir[Rails.root.join("app/domains/**/setup.rb")]
+
+    puts "Reloading #{setup_files.size} domain(s)..."
+
+    setup_files.each do |setup_file|
+      load setup_file
+
+      domain_path = setup_file.gsub(Rails.root.join("app/domains/").to_s, "")
+      domain_name = domain_path.split("/").first.camelize
+
+      domain_module = domain_name.constantize rescue nil
+      if domain_module && domain_module.respond_to?(:setup!)
+        domain_module.setup!
+        puts "  ✓ #{domain_name}"
+      end
+    end
+
+    puts "Done!"
+  end
+end

data/lib/smart_domain/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module SmartDomain
+  VERSION = "0.1.0"
+end

data/lib/smart_domain.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+require "active_model"
+require "active_support"
+require "active_support/core_ext"
+require "active_record"
+require "logger"
+
+require_relative "smart_domain/version"
+require_relative "smart_domain/configuration"
+
+# Event system
+require_relative "smart_domain/event/base"
+require_relative "smart_domain/event/mixins"
+require_relative "smart_domain/event/handler"
+require_relative "smart_domain/event/adapters/memory"
+
+# Handlers
+require_relative "smart_domain/handlers/audit_handler"
+require_relative "smart_domain/handlers/metrics_handler"
+
+# Event registration
+require_relative "smart_domain/event/registration"
+
+# Domain patterns
+require_relative "smart_domain/domain/exceptions"
+require_relative "smart_domain/domain/policy"
+require_relative "smart_domain/domain/service"
+
+# Rails integration
+require_relative "smart_domain/integration/active_record"
+require_relative "smart_domain/integration/multi_tenancy"
+
+# Railtie (loads automatically if Rails is present)
+require_relative "smart_domain/railtie" if defined?(Rails::Railtie)
+
+# SmartDomain - Domain-Driven Design and Event-Driven Architecture for Rails
+#
+# SmartDomain brings battle-tested DDD/EDA patterns from the Aeyes healthcare
+# platform to Rails applications. It provides:
+#
+# - Domain events with event bus
+# - Event mixins for 70% boilerplate reduction
+# - Generic handlers for audit and metrics
+# - Domain service pattern
+# - Rails generators for rapid scaffolding
+#
+# @example Quick Start
+#   # In config/initializers/smart_domain.rb
+#   SmartDomain.configure do |config|
+#     config.event_bus_adapter = :memory
+#     config.audit_table_enabled = true
+#   end
+#
+#   # Define a domain event
+#   class UserCreatedEvent < SmartDomain::Event::Base
+#     attribute :user_id, :string
+#     attribute :email, :string
+#   end
+#
+#   # Publish an event
+#   event = UserCreatedEvent.new(
+#     event_type: 'user.created',
+#     aggregate_id: user.id,
+#     aggregate_type: 'User',
+#     organization_id: org.id,
+#     user_id: user.id,
+#     email: user.email
+#   )
+#   SmartDomain::Event.bus.publish(event)
+#
+# @see https://github.com/rachidalmaach/smart_domain
+module SmartDomain
+  class Error < StandardError; end
+
+  # Your code goes here...
+end

data/smart_domain.gemspec

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+require_relative "lib/smart_domain/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "smart_domain"
+  spec.version = SmartDomain::VERSION
+  spec.authors = ["Rachid Al Maach"]
+  spec.email = ["rachid@qraft.nl"]
+
+  spec.summary = "Smart Domain-Driven Design and Event-Driven Architecture for Rails"
+  spec.description = <<~DESC
+    SmartDomain brings battle-tested DDD/EDA patterns to Rails applications.
+    Inspired by the Aeyes healthcare platform, it provides domain events,
+    event bus, generic handlers, and Rails generators for rapid domain scaffolding.
+    Features 70% boilerplate reduction through intelligent event handling and
+    AI-augmented development patterns.
+  DESC
+  spec.homepage = "https://github.com/rachid/smart_domain"
+  spec.license = "MIT"
+  spec.required_ruby_version = ">= 3.0.0"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = "https://github.com/rachid/smart_domain"
+  spec.metadata["changelog_uri"] = "https://github.com/rachid/smart_domain/blob/main/CHANGELOG.md"
+
+  spec.files = Dir.chdir(__dir__) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      (File.expand_path(f) == __FILE__) ||
+        f.start_with?(*%w[bin/ test/ spec/ features/ .git .github appveyor Gemfile])
+    end
+  end
+
+  spec.bindir = "exe"
+  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  # Core dependencies
+  spec.add_dependency "rails", ">= 7.0"
+  spec.add_dependency "activemodel", ">= 7.0"
+  spec.add_dependency "activesupport", ">= 7.0"
+  spec.add_dependency "activerecord", ">= 7.0"
+
+  # Development dependencies
+  spec.add_development_dependency "rspec", "~> 3.12"
+  spec.add_development_dependency "rspec-rails", "~> 6.0"
+  spec.add_development_dependency "factory_bot_rails", "~> 6.2"
+  spec.add_development_dependency "faker", "~> 3.2"
+  spec.add_development_dependency "rubocop", "~> 1.50"
+  spec.add_development_dependency "rubocop-rails", "~> 2.19"
+  spec.add_development_dependency "rubocop-rspec", "~> 2.20"
+  spec.add_development_dependency "sqlite3", ">= 2.1"
+end

metadata

@@ -0,0 +1,391 @@
+--- !ruby/object:Gem::Specification
+name: smart_domain
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Rachid Al Maach
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2025-12-31 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+- !ruby/object:Gem::Dependency
+  name: activemodel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+- !ruby/object:Gem::Dependency
+  name: rspec-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: factory_bot_rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.2'
+- !ruby/object:Gem::Dependency
+  name: faker
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.50'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.50'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.19'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.19'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.20'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.20'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.1'
+description: |
+  SmartDomain brings battle-tested DDD/EDA patterns to Rails applications.
+  Inspired by the Aeyes healthcare platform, it provides domain events,
+  event bus, generic handlers, and Rails generators for rapid domain scaffolding.
+  Features 70% boilerplate reduction through intelligent event handling and
+  AI-augmented development patterns.
+email:
+- rachid@qraft.nl
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rspec"
+- CHANGELOG.md
+- LICENSE
+- README.md
+- Rakefile
+- examples/blog_app/.dockerignore
+- examples/blog_app/.github/dependabot.yml
+- examples/blog_app/.github/workflows/ci.yml
+- examples/blog_app/.gitignore
+- examples/blog_app/.kamal/hooks/docker-setup.sample
+- examples/blog_app/.kamal/hooks/post-app-boot.sample
+- examples/blog_app/.kamal/hooks/post-deploy.sample
+- examples/blog_app/.kamal/hooks/post-proxy-reboot.sample
+- examples/blog_app/.kamal/hooks/pre-app-boot.sample
+- examples/blog_app/.kamal/hooks/pre-build.sample
+- examples/blog_app/.kamal/hooks/pre-connect.sample
+- examples/blog_app/.kamal/hooks/pre-deploy.sample
+- examples/blog_app/.kamal/hooks/pre-proxy-reboot.sample
+- examples/blog_app/.kamal/secrets
+- examples/blog_app/.rubocop.yml
+- examples/blog_app/.ruby-version
+- examples/blog_app/Dockerfile
+- examples/blog_app/Gemfile
+- examples/blog_app/Gemfile.lock
+- examples/blog_app/README.md
+- examples/blog_app/README_EXAMPLE.md
+- examples/blog_app/Rakefile
+- examples/blog_app/app/assets/images/.keep
+- examples/blog_app/app/assets/stylesheets/application.css
+- examples/blog_app/app/controllers/api/base_controller.rb
+- examples/blog_app/app/controllers/api/v1/posts_controller.rb
+- examples/blog_app/app/controllers/api/v1/users_controller.rb
+- examples/blog_app/app/controllers/application_controller.rb
+- examples/blog_app/app/controllers/concerns/.keep
+- examples/blog_app/app/domains/.keep
+- examples/blog_app/app/domains/exceptions.rb
+- examples/blog_app/app/domains/post_management/events/post_created_event.rb
+- examples/blog_app/app/domains/post_management/events/post_deleted_event.rb
+- examples/blog_app/app/domains/post_management/events/post_updated_event.rb
+- examples/blog_app/app/domains/post_management/handlers/post_notification_handler.rb
+- examples/blog_app/app/domains/post_management/models/post.rb
+- examples/blog_app/app/domains/post_management/policies/post_policy.rb
+- examples/blog_app/app/domains/post_management/post_service.rb
+- examples/blog_app/app/domains/post_management/setup.rb
+- examples/blog_app/app/domains/user_management/events/user_created_event.rb
+- examples/blog_app/app/domains/user_management/events/user_deleted_event.rb
+- examples/blog_app/app/domains/user_management/events/user_updated_event.rb
+- examples/blog_app/app/domains/user_management/handlers/user_welcome_handler.rb
+- examples/blog_app/app/domains/user_management/models/user.rb
+- examples/blog_app/app/domains/user_management/policies/user_policy.rb
+- examples/blog_app/app/domains/user_management/setup.rb
+- examples/blog_app/app/domains/user_management/user_service.rb
+- examples/blog_app/app/events/.keep
+- examples/blog_app/app/events/application_event.rb
+- examples/blog_app/app/handlers/.keep
+- examples/blog_app/app/helpers/application_helper.rb
+- examples/blog_app/app/javascript/application.js
+- examples/blog_app/app/javascript/controllers/application.js
+- examples/blog_app/app/javascript/controllers/hello_controller.js
+- examples/blog_app/app/javascript/controllers/index.js
+- examples/blog_app/app/jobs/application_job.rb
+- examples/blog_app/app/mailers/application_mailer.rb
+- examples/blog_app/app/models/application_record.rb
+- examples/blog_app/app/models/concerns/.keep
+- examples/blog_app/app/models/organization.rb
+- examples/blog_app/app/policies/.keep
+- examples/blog_app/app/policies/application_policy.rb
+- examples/blog_app/app/services/.keep
+- examples/blog_app/app/services/application_service.rb
+- examples/blog_app/app/views/layouts/application.html.erb
+- examples/blog_app/app/views/layouts/mailer.html.erb
+- examples/blog_app/app/views/layouts/mailer.text.erb
+- examples/blog_app/app/views/pwa/manifest.json.erb
+- examples/blog_app/app/views/pwa/service-worker.js
+- examples/blog_app/bin/brakeman
+- examples/blog_app/bin/bundler-audit
+- examples/blog_app/bin/ci
+- examples/blog_app/bin/dev
+- examples/blog_app/bin/docker-entrypoint
+- examples/blog_app/bin/importmap
+- examples/blog_app/bin/jobs
+- examples/blog_app/bin/kamal
+- examples/blog_app/bin/rails
+- examples/blog_app/bin/rake
+- examples/blog_app/bin/rubocop
+- examples/blog_app/bin/setup
+- examples/blog_app/bin/thrust
+- examples/blog_app/config.ru
+- examples/blog_app/config/application.rb
+- examples/blog_app/config/boot.rb
+- examples/blog_app/config/bundler-audit.yml
+- examples/blog_app/config/cable.yml
+- examples/blog_app/config/cache.yml
+- examples/blog_app/config/ci.rb
+- examples/blog_app/config/credentials.yml.enc
+- examples/blog_app/config/database.yml
+- examples/blog_app/config/deploy.yml
+- examples/blog_app/config/environment.rb
+- examples/blog_app/config/environments/development.rb
+- examples/blog_app/config/environments/production.rb
+- examples/blog_app/config/environments/test.rb
+- examples/blog_app/config/importmap.rb
+- examples/blog_app/config/initializers/active_domain.rb
+- examples/blog_app/config/initializers/assets.rb
+- examples/blog_app/config/initializers/content_security_policy.rb
+- examples/blog_app/config/initializers/filter_parameter_logging.rb
+- examples/blog_app/config/initializers/inflections.rb
+- examples/blog_app/config/locales/en.yml
+- examples/blog_app/config/master.key
+- examples/blog_app/config/puma.rb
+- examples/blog_app/config/queue.yml
+- examples/blog_app/config/recurring.yml
+- examples/blog_app/config/routes.rb
+- examples/blog_app/config/storage.yml
+- examples/blog_app/db/cable_schema.rb
+- examples/blog_app/db/cache_schema.rb
+- examples/blog_app/db/migrate/20251230112502_create_organizations.rb
+- examples/blog_app/db/migrate/20251230112503_create_users.rb
+- examples/blog_app/db/migrate/20251230112504_create_posts.rb
+- examples/blog_app/db/queue_schema.rb
+- examples/blog_app/db/schema.rb
+- examples/blog_app/db/seeds.rb
+- examples/blog_app/lib/api_demo.rb
+- examples/blog_app/lib/demo.rb
+- examples/blog_app/lib/tasks/.keep
+- examples/blog_app/log/.keep
+- examples/blog_app/public/400.html
+- examples/blog_app/public/404.html
+- examples/blog_app/public/406-unsupported-browser.html
+- examples/blog_app/public/422.html
+- examples/blog_app/public/500.html
+- examples/blog_app/public/icon.png
+- examples/blog_app/public/icon.svg
+- examples/blog_app/public/robots.txt
+- examples/blog_app/script/.keep
+- examples/blog_app/storage/.keep
+- examples/blog_app/tmp/.keep
+- examples/blog_app/vendor/.keep
+- examples/blog_app/vendor/javascript/.keep
+- lib/generators/active_domain/domain/domain_generator.rb
+- lib/generators/active_domain/domain/templates/events/created_event.rb.tt
+- lib/generators/active_domain/domain/templates/events/deleted_event.rb.tt
+- lib/generators/active_domain/domain/templates/events/updated_event.rb.tt
+- lib/generators/active_domain/domain/templates/policy.rb.tt
+- lib/generators/active_domain/domain/templates/service.rb.tt
+- lib/generators/active_domain/domain/templates/setup.rb.tt
+- lib/generators/active_domain/install/install_generator.rb
+- lib/generators/active_domain/install/templates/README
+- lib/generators/active_domain/install/templates/application_event.rb
+- lib/generators/active_domain/install/templates/application_policy.rb
+- lib/generators/active_domain/install/templates/application_service.rb
+- lib/generators/active_domain/install/templates/initializer.rb
+- lib/smart_domain.rb
+- lib/smart_domain/configuration.rb
+- lib/smart_domain/domain/exceptions.rb
+- lib/smart_domain/domain/policy.rb
+- lib/smart_domain/domain/service.rb
+- lib/smart_domain/event/adapters/memory.rb
+- lib/smart_domain/event/base.rb
+- lib/smart_domain/event/handler.rb
+- lib/smart_domain/event/mixins.rb
+- lib/smart_domain/event/registration.rb
+- lib/smart_domain/generators/domain_generator.rb
+- lib/smart_domain/generators/install_generator.rb
+- lib/smart_domain/handlers/audit_handler.rb
+- lib/smart_domain/handlers/metrics_handler.rb
+- lib/smart_domain/integration/active_record.rb
+- lib/smart_domain/integration/multi_tenancy.rb
+- lib/smart_domain/railtie.rb
+- lib/smart_domain/tasks/domains.rake
+- lib/smart_domain/version.rb
+- smart_domain.gemspec
+homepage: https://github.com/rachid/smart_domain
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/rachid/smart_domain
+  source_code_uri: https://github.com/rachid/smart_domain
+  changelog_uri: https://github.com/rachid/smart_domain/blob/main/CHANGELOG.md
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Smart Domain-Driven Design and Event-Driven Architecture for Rails
+test_files: []