エピローグ — DDDは目的ではなく手段

# 過剰適用: お知らせ管理にDDDを適用した結果（3日かかった）
module AnnouncementContext
  class Announcement
    attr_reader :id, :title, :body, :published_at
    def initialize(id:, title:, body:, published_at: nil)
      @id = id
      @title = title
      @body = body
      @published_at = published_at
      freeze
    end
 
    def published?
      @published_at.present?
    end
    # これ以上ビジネスロジックがない...
  end
 
  module AnnouncementRepositoryInterface
    def find(id); raise NotImplementedError; end
    def save(announcement); raise NotImplementedError; end
    def find_published; raise NotImplementedError; end
  end
 
  class ActiveRecordAnnouncementRepository
    include AnnouncementRepositoryInterface
 
    def find(id)
      record = AnnouncementRecord.find(id)
      Announcement.new(
        id: record.id,
        title: record.title,
        body: record.body,
        published_at: record.published_at
      )
    end
 
    def save(announcement)
      record = AnnouncementRecord.find_or_initialize_by(id: announcement.id)
      record.update!(
        title: announcement.title,
        body: announcement.body,
        published_at: announcement.published_at
      )
    end
  end
 
  class CreateAnnouncementUseCase
    def call(title:, body:)
      announcement = Announcement.new(id: SecureRandom.uuid, title: title, body: body)
      @repository.save(announcement)
      UseCaseResult.success(announcement)
    end
  end
end

# 正解: シンプルなCRUDのままで良かった（3時間で実装）
class Announcement < ApplicationRecord
  validates :title, :body, presence: true
  validates :title, length: { maximum: 100 }
 
  scope :published, -> { where.not(published_at: nil).order(published_at: :desc) }
  scope :draft,     -> { where(published_at: nil) }
 
  def published?
    published_at.present?
  end
 
  def publish!
    update!(published_at: Time.current)
  end
end

# やりすぎ: 粒度が細かすぎる値オブジェクト群
class OrderItemQuantity
  attr_reader :value
  def initialize(value)
    raise ArgumentError, "数量は1以上" if value < 1
    @value = Integer(value)
    freeze
  end
  def +(other) = OrderItemQuantity.new(@value + other.value)
end
 
class OrderItemProductId
  attr_reader :value
  def initialize(value)
    raise ArgumentError, "商品IDは必須" if value.blank?
    @value = value.to_s
    freeze
  end
end
 
class OrderItemProductName
  attr_reader :value
  def initialize(value)
    raise ArgumentError, "商品名は必須" if value.blank?
    @value = value.to_s
    freeze
  end
end

# バランスが取れた粒度
# Money: 金額と通貨が不可分 → 値オブジェクト
# DeliveryAddress: 複数のフィールドが1つの「住所」という概念 → 値オブジェクト
# 商品ID: ただの文字列 → Stringのまま
# 数量: 1以上の整数 → Integerのまま（バリデーションはOrderItemエンティティで）
 
module OrderContext
  class OrderItem
    attr_reader :id, :product_id, :product_name, :unit_price, :quantity
 
    def initialize(id:, product_id:, product_name:, unit_price:, quantity:)
      raise ArgumentError, "数量は1以上" if quantity < 1
      @id = id
      @product_id = product_id           # String — そのまま
      @product_name = product_name       # String — そのまま
      @unit_price = unit_price           # Money — 値オブジェクト（通貨の概念があるから）
      @quantity = Integer(quantity)      # Integer — そのまま
      freeze
    end
 
    def subtotal
      unit_price * quantity
    end
  end
end

# レガシーコードを抱えたファイルへのコミット
# Bad: 全部を「正しいDDD」に書き直そうとする
# Good: 変更するメソッドだけをDDDパターンに改善する
 
# たとえば cancel! を変更するなら、confirm! も一緒に直したくなるが、
# confirm! は今触らなくていい。cancel! だけ直す。
class Order < ApplicationRecord
  # 既存のままのレガシーコード（触らない）
  def confirm!
    # ... 100行のレガシーコード
  end
 
  # 新しく書き直したキャンセル処理（ドメインオブジェクトに委譲）
  def cancel!(reason:)
    domain_order = OrderContext::Order.restore_from_record(self)
    domain_order.cancel!(reason: reason)
    update!(status: domain_order.status.to_s, cancelled_at: domain_order.cancelled_at)
    domain_order.domain_events.each { |event| EventBus.publish(event) }
  end
end

# FreshCart 用語統一宣言 v1.0
 
## 廃止する言葉 → 採用する言葉
- 「在庫引き当て / inventory hold / stock lock」→ StockReservation
- 「注文確定 / finalize / complete」→ OrderConfirmation
- 「ユーザー（注文文脈）」→ Customer（アカウント文脈ではUserのまま）
- 「商品（注文文脈）」→ OrderableProduct（カタログ文脈ではProductのまま）
 
## 合意ルール
- Slackでの会話でも上記の言葉を使う
- PRのタイトルとコミットメッセージに用語を含める
- ドキュメントの改訂時に古い言葉を修正する

# バグトラッカーと git log から定量的に分析する
# ツール: git log で変更頻度を確認
 
# git log で最もコミット数が多いファイルを確認
# $ git log --format=format: --name-only | sort | uniq -c | sort -rg | head -20
#
# 結果例:
#   89 app/models/order.rb       ← 最も変更が多い
#   67 app/models/stock.rb
#   45 app/controllers/orders_controller.rb
#   23 app/models/product.rb
 
# バグトラッカーから: 過去3ヶ月で最もバグが発生したモデル
# Order: 23件
# Stock: 15件
# → OrderとStockをDDDでリファクタリングすることが最大のROI

# Orderのリファクタリング前に、現在の振る舞いをテストで記録
# 「キャラクタライゼーションテスト」と呼ばれる技法
RSpec.describe '注文確定の現在の振る舞い（変更前の記録）' do
  it '在庫がある場合、注文が確定される' do
    order = create(:order, :pending, :with_items)
    create(:stock, product: order.order_items.first.product, quantity: 100)
 
    expect { order.confirm! }.to change { order.reload.status }.to('confirmed')
  end
 
  it '在庫がない場合、例外が発生する' do
    order = create(:order, :pending, :with_items)
    create(:stock, product: order.order_items.first.product, quantity: 0)
 
    expect { order.confirm! }.to raise_error(ActiveRecord::RecordInvalid)
  end
 
  it '確定後にメールが送信される' do
    order = create(:order, :pending, :with_items)
    create(:stock, product: order.order_items.first.product, quantity: 100)
 
    expect { order.confirm! }.to have_enqueued_mail(OrderMailer, :confirmation)
  end
end

# 在庫引き当てに関するコードを探す
$ find app/domains/inventory_context -name "*.rb"
app/domains/inventory_context/stock.rb
app/domains/inventory_context/stock_reservation.rb
app/domains/inventory_context/services/stock_reservation_service.rb
 
# 3ファイルだけ。全部読むのに10分かからない

// Golangではインターフェースが依存性を明確にする
type OrderRepository interface {
    FindByID(ctx context.Context, id string) (*Order, error)
    Save(ctx context.Context, order *Order) error
    FindByCustomer(ctx context.Context, customerID string, pagination Pagination) ([]*Order, error)
}
 
// 具体実装はインターフェースを満たす
type postgresOrderRepository struct {
    db *sql.DB
}
 
func (r *postgresOrderRepository) FindByID(ctx context.Context, id string) (*Order, error) {
    // ...
}
 
// ユースケースはインターフェースに依存（具体実装を知らない）
type ConfirmOrderUseCase struct {
    orderRepo  OrderRepository  // インターフェース
    stockSvc   StockReservationService
    eventBus   EventBus
}