feat: add User domain layer / Userドメイン層の追加

[zigzagdev]

Summary

Content

• Add AgeRange enum representing user age bracket categories
• Add Subscription value object with SubscriptionTier enum and active/expired/free state logic
• Add UserEntity value object aggregating user identity and subscription
• Add SubscriptionFactory and UserEntityFactory for constructing domain objects from raw data

Changes

File	Description
AgeRange.php	Backed enum for age range (teens / 20s–60+)
Subscription/SubscriptionTier.php	Backed enum for subscription tier (free / premium)
Subscription/Subscription.php	Value object with isActive(), isExpired(), isFree()
UserEntity.php	Immutable value object holding user identity + subscription
Factory/SubscriptionFactory.php	Builds Subscription from raw array, handles string→DateTimeImmutable cast
Factory/UserEntityFactory.php	Builds UserEntity from raw array via SubscriptionFactory

---

概要

内容

• AgeRange enum — ユーザーの年齢帯を表す列挙型
• Subscription 値オブジェクト — SubscriptionTier enumとisActive()/isExpired()/isFree()のサブスクリプション状態ロジック
• UserEntity 値オブジェクト — ユーザーの識別情報とサブスクリプションを集約
• SubscriptionFactory / UserEntityFactory — 生データからドメインオブジェクトを構築するファクトリ

変更内容

ファイル	説明
AgeRange.php	年齢帯のバック付きenum（teens / 20s〜60+）
Subscription/SubscriptionTier.php	サブスクリプションティアのバック付きenum（free / premium）
Subscription/Subscription.php	isActive()・isExpired()・isFree()を持つ値オブジェクト
UserEntity.php	ユーザー識別情報とサブスクリプションを保持するimmutableな値オブジェクト
Factory/SubscriptionFactory.php	生配列からSubscriptionを生成（文字列→DateTimeImmutableのキャスト含む）
Factory/UserEntityFactory.php	SubscriptionFactoryを介して生配列からUserEntityを生成

[zigzagdev]

Ok