webman-best-practices

Webman フレームワークにおける、DDD アーキテクチャ、依存関係のルール、PER Coding Style に準拠したベストプラクティスです。

アーキテクチャと依存関係

• コントローラーがサービス層を省略してモデルに直接依存している → controller-skip-serviceを参照
• ドメイン層がフレームワークのクラス（Request、DB など）に依存している → domain-framework-dependencyを参照
• サービス層が別のサービスと循環依存している → service-circular-dependencyを参照
• インフラストラクチャ層が Contract インターフェースを実装していない → infrastructure-without-contractを参照
• リポジトリではなく、サービス内でモデルを直接使用している → service-direct-model-accessを参照

命名規則

• ディレクトリ名に camelCase または PascalCase を使用している → directory-lowercaseを参照
• インターフェース名に Interface サフィックスがない → interface-namingを参照
• サービス名が VerbNounService パターンに従っていない → service-naming-patternを参照
• リポジトリの実装名に説明的なプレフィックスがない → repository-implementation-namingを参照
• 名前空間がディレクトリ構造と一致していない → namespace-directory-mismatchを参照

コードスタイル（PER Coding Style）

• ファイルの先頭に declare(strict_types=1) がない → strict-types-declarationを参照
• デフォルトで final class を使用していない → prefer-final-classesを参照
• 不変のプロパティに readonly を使用していない → readonly-propertiesを参照
• パラメーターまたは戻り値の型宣言がない → complete-type-declarationsを参照
• コンストラクターのプロパティプロモーションを使用していない → constructor-property-promotionを参照

ドメインパターン

• エンティティに一意の識別子がない → entity-identityを参照
• 値オブジェクトが変更可能である → value-object-immutabilityを参照
• ドメインではなくサービスにビジネスロジックがある → business-logic-in-domainを参照
• 副作用にドメインイベントを使用していない → domain-eventsを参照
• ゲッターとセッターだけの貧血ドメインモデルになっている → rich-domain-modelを参照

依存性注入

• 依存性注入ではなく静的メソッドを使用している → avoid-static-methodsを参照
• コンストラクターインジェクションを使用していない → constructor-injectionを参照
• 依存性注入ではなくサービスロケーターパターンを使用している → no-service-locatorを参照