Feature Variants: API design and architecture review

[kukv]

Summary

Feature Variants 機能の API 設計とアーキテクチャを検討する設計 Issue。

Discussion Points

• @FeatureVariant vs @EndpointGate の拡張、どちらのアプローチが適切か
• VariantProvider SPI の設計（String getVariant(String featureName, String userId)）
• Consistent hashing のアルゴリズム選定
• @ResolvedVariant 引数リゾルバーの設計
• 既存の EndpointGateProvider / EndpointGateEvaluationPipeline との関係性
• バリアントの設定方法（YAML / Actuator / 外部ストア）

Acceptance Criteria

• API 設計ドキュメントが合意されていること
• 実装 sub-issue のスコープが確定していること

Related

• Parent: Feature Variants（多値フラグ / A/Bテスト） #31