為了讓核心的 Domain Model 的 Business Logic 受到完整的保護。 優點：
- 保持靈活性、移植性不依賴 Framework
- Domain Model(這專案是 Order) 是獨立的，因此可快速測試系統核心邏輯
- 內層核心不會呼叫外層的元件，而是由外層反轉注入內層核心
App\Http\Controllers\CheckAndTransformOrderController
-
SRP: 處理訂單檢查和轉換的 HTTP 請求。不涉及其他責任（如：具體的貨幣轉換邏輯、訂單驗證邏輯）。
-
OCP: 對擴展開放、修改封閉。可以通過注入不同的 CurrencyConverterInterface 實現來擴展貨幣轉換功能，而不需要修改 Controller 代碼。
-
LSP: 依賴於 CurrencyConverterInterface，外部服務只需要依賴 Interface 即可。
-
ISP: 只依賴於 CurrencyConverterInterface，該 Interface 只包含必要的方法，不會讓 Controller 依賴不需要的方法。
-
DIP: 依賴於抽象的 CurrencyConverterInterface，而不是 concrete，實現解耦。
-
Dependency Injection: CurrencyConverterInterface 通過 construct 注入到 CheckAndTransformOrderController，可以動態地使用 OrderServiceProvider 調整貨幣轉換的策略與驗證規則。
Modules\Order\UseCases\CurrencyConverter
-
SRP: CurrencyConverter 的單一職責是處理貨幣轉換。它的所有方法和屬性都支持這一職責，而不涉及其他責任（如：驗證訂單邏輯、貨幣轉換策略產生）。
-
OCP: CurrencyConverter 擴展開放（可以通過添加新的貨幣轉換策略進行擴展），對修改封閉（不需要修改現有代碼即可添加新功能）。 Example：使用 CurrencyStrategyFactory 來建立不同的策略，可以通過加入新的 Strategy 來擴展貨幣轉換功能，而不需要修改 CurrencyConverter 的代碼。
-
LSP: CurrencyConverter implements CurrencyConverterInterface，因此外部服務只需要依賴 Interface 即可。
-
ISP: CurrencyConverter implements CurrencyConverterInterface，這個 interface 只包含必要的方法，不會讓 implementing classes 依賴不需要的 method。
-
DIP: CurrencyConverter 依賴於 Interface(CurrencyStrategyFactoryInterface, OrderFormatValidatorInterface)，而不是具體的實現。
Modules\Order\ConversionStrategies\CurrencyStrategyFactory
- 實作抽象工廠模式，負責產生貨幣轉換的物件，當加入新的貨幣轉換功能只需要修改此工廠即可。
Modules\Order\Validators\OrderFormatValidator
- 實作策略模式，透過 $validationRules 動態調整 Validation Rules，每個 Rule 實現了 ValidationRule Interface。
.
├── app
│ ├── Constants
│ ├── Http
│ └── Providers
├── docker
│ └── php
├── html-coverage
├── modules
│ ├── Order
│ └── Shared
├── tests
│ ├── Feature
│ └── Unit
....
包含 Application 的邏輯和組件，有可能是 HTTP、Command、Scheduler 等應用程式形態出現。
- Constants：用於存放常量定義，例如: Route Path
- Http：包含 Controller、FormRequest 等與 HTTP 請求處理相關的 Class
- Providers：Service Provider，用於註冊服務和依賴注入，例如: OrderServiceProvider
用於存放 Docker 配置文件和相關資源
- php：包含 PHP8.3 相關的 Dockerfile
$ ./vendor/bin/phpunit
Code Coverage Report，通常由 phpunit 工具生成 ./html-coverage
用於組織模組化與業務邏輯的專案結構，每個子目錄代表一個獨立的功能模組
- Order：與訂單處理相關的模組
- Shared：包含多個模組之間共享的程式碼和資源
包含測試程式碼
-
Feature：功能測試，通常用於測試應用程式的完整行為
./tests/Feature/CheckAndTransformOrderControllerTest.php包含題目需求的功能測試：- name
- 包含非英文字母，丟出 400 - Name contains non-English characters
- 每個單詞首字母非大寫，丟出 400 - Name is not capitalized
- price
- 訂單金額超過 2000，丟出 400 - Price is over 2000
- currency
- 貨幣格式若非 TWD 或 USD，丟出 400 - Currency format is wrong
- 當貨幣為 USD 時，需修改 price 金額乘上固定匯率 31 元，並且將 currency 改為 TWD
- name
- Unit：單元測試
....
本專案實作了持續集成（CI）以確保代碼質量，並自動生成代碼覆蓋率報告。使用 GitHub Actions 進行 CI，並使用 Codacy 進行代碼覆蓋率報告。