Query - 重新思考 Rails 架構

 1module Shipments
 2  module Query
 3    class FindShipment
 4      attr_reader :shipment_repository
 5
 6      def initialize(shipment_repository:)
 7        @shipment_repository = shipment_repository
 8      end
 9
10      def execute(shipment_id)
11        shipment_repository.find_shipment(shipment_id.to_i)
12      end
13    end
14  end
15end

 1Feature: Shipment
 2  # ...
 3  Scenario: I can get the shipment
 4    Given there have some shipment route
 5      | route_id | shipment_id | delivered_at         |
 6      | OKA      | 1           | 2024-03-19T00:00:00Z |
 7    When I make a GET request to "/shipments/1"
 8    Then the response should be
 9      """
10      {
11        "id": 1,
12        "state": "shipping",
13        "routes": [
14          {
15            "route_id": "OKA",
16            "shipment_id": 1,
17            "delivered_at": "2024-03-19T00:00:00.000Z"
18          }
19        ]
20      }
21      """

1When('I make a GET request to {string}') do |path|
2  @response = get path
3end

1# ...
2  resources :shipments, module: :shipments, defaults: { format: :json } do
3    resources :routes, only: [:create], defaults: { format: :json }
4  end

1module Shipments
2  class ShipmentsController < ApplicationController
3    def show
4      query = Shipments::Query::FindShipment.new(shipment_repository: ShipmentRoute)
5      @shipment = query.execute(params[:id])
6    end
7  end
8end

1json.id @shipment.id
2json.state @shipment.state
3json.routes @shipment.routes do |route|
4  json.route_id route.id
5  json.delivered_at route.delivered_at.utc
6  json.shipment_id @shipment.id
7end