APIエンドポイントとリクエストバリデーションを実装

[en-Barry]

要約

Issue #7（GET /api/v1/electricity_bill_simulations エンドポイントの TDD 実装）を解決する。

• ElectricityBillSimulationParams（Form Object）でリクエストパラメータの検証と JSON:API エラー配列生成を担い、コントローラは薄く保つ
• i18n は ActiveModel 標準機構（activemodel.errors.models.*）で ja.yml に一元管理

Closes #7

実装してみて発生した追加判断

• ActiveModel::Attributes を使わず attr_writer + reader override を採用: attribute :kwh, :integer を使うと "100.5" → 100 に黙示切り捨てされ「小数を弾く」テストが失敗する。cast_to_integer が Integer("100.5") で ArgumentError を捕捉し生値を返すことで、numericality が :not_an_integer を立てる設計にした
• VALID_AMPERES / MAX_KWH を ElectricityBillConstants モジュールに切り出し: 同じ定数が ElectricityBillSimulationParams と ElectricityBillSimulator に重複・名称不統一で定義されており、片方だけ変更したときの不整合を防ぐため app/models/concerns/electricity_bill_constants.rb に一元化した

テストケース一覧

spec/forms/electricity_bill_simulation_params_spec.rb（14 examples）

ケース	入力	期待
有効値（ampere=30）は valid	ampere=30, kwh=400	valid
上限ぎりぎり kwh=9999 は valid	ampere=30, kwh=9999	valid
AMPERE_VALUES 外（25）は inclusion エラー	ampere=25, kwh=400	errors[:ampere]
ampere 欠落は blank エラー	ampere=nil, kwh=400	errors[:ampere]
ampere が非数値文字列（"abc"）は inclusion エラー	ampere=abc, kwh=400	errors[:ampere]
kwh 欠落は blank エラー	ampere=30, kwh=nil	errors[:kwh]
負の kwh（-1）は greater_than_or_equal_to エラー	ampere=30, kwh=-1	errors[:kwh]
小数（"100.5"）は not_an_integer エラー	ampere=30, kwh=100.5	errors[:kwh]
上限超過（10000）は less_than_or_equal_to エラー	ampere=30, kwh=10000	errors[:kwh]
非数値文字列（"abc"）は not_a_number エラー	ampere=30, kwh=abc	errors[:kwh]
両方不正は 2 件のエラー	ampere=25, kwh=-1	errors 2件
両方欠落は 2 件のエラー	ampere=nil, kwh=nil	errors 2件
jsonapi_errors が正しいキー構造を返す	ampere=25	status/title/detail/source.parameter
jsonapi_errors が全件返す	ampere=nil, kwh=nil	2件

spec/requests/api/v1/electricity_bill_simulations_spec.rb（3 examples）

ケース	パラメータ	期待
正常系	ampere=30&kwh=400	status 200 / data 配列に provider_name / plan_name / price
単一エラー	ampere=25&kwh=400	status 400 / errors[0] が JSON:API 形式
パラメータなし	（なし）	status 400 / errors が 2 件