Documentation
Apex Stem を構成するアーキテクチャと OSS の解説をまとめています。 まずは はじめに から、必要に応じて各章へ進んでください。
はじめに
Getting Started
設計思想
Architecture
Handler-Usecase Architecture
Apex Stem の中核アーキテクチャ。なぜ 2 層なのか、Handler と Usecase それぞれの責務、部品クラスの扱いを通して解説します。
Layered Constructor Pattern
DI コンテナを使わずに、本番用のシンプルな API とテスト用の柔軟な依存注入を 1 つの Usecase クラスで両立する設計パターンを解説します。
テスト戦略
Handler-Usecase Architecture の 2 層を、Usecase 単体テスト (ApexEloquent) と Handler 結合テスト (ApexBlueprint) に 1 対 1 で対応させるテスト戦略を解説します。
OSS ガイド
Libraries
ApexEloquent ガイド
Apex Stem の中心 OSS、ApexEloquent の入り口。クエリビルダー / データアクセス / 関連オブジェクトの 3 つのトピックページへ案内します。
ApexBlueprint ガイド
Apex Stem の結合テストデータ生成 OSS、 ApexBlueprint の入り口。 Setup / 使い方ガイド / API リファレンス / Deep Dives の 4 段構えで構成された総合ガイドです。
ApexTrace ガイド
Usecase のライフサイクルログとテスト検証を担う ApexTrace の総合ガイド。Trace の 4 つのライフサイクルメソッド、TraceFlow、ネスト、2 つのモードを 1 本で解説します。
ApexTools ガイド
Apex Stem の基盤層を担う ApexTools の入り口。収録されているツールを一覧で示し、各ツールの詳細ページへ案内します。
このあとに追加予定
ApexBlueprint の日本語ガイドや Result DTO 規約の章を順次公開します。ApexEloquent の Deep Dive (設計の動機・独自機能の深掘り) は ApexEloquent ガイド 内にまとめています。 最新の進捗は GitHub から追えます。