Feature Flag System

Table of Contents

• Overview
• When to Use
• Quick Start
• Reference Guides
• Best Practices

Overview

デプロイをリリースと分離し、段階的なロールアウト、A/B テスト、および緊急時のキルスイッチを可能にするため、フィーチャーフラグを実装します。

When to Use

• 段階的なフィーチャーロールアウト
• A/B テストと実験
• カナリアデプロイメント
• 特定のユーザーへのベータ機能
• 緊急時のキルスイッチ
• Trunk-based development
• Dark launching
• オペレーショナルフラグ(メンテナンスモード)
• ユーザー固有の機能

Quick Start

最小限の実装例:

interface FlagConfig {
  key: string;
  enabled: boolean;
  description: string;
  rules?: FlagRule[];
  variants?: FlagVariant[];
  createdAt: Date;
  updatedAt: Date;
}

interface FlagRule {
  type: "user" | "percentage" | "attribute" | "datetime";
  operator: "in" | "equals" | "contains" | "gt" | "lt" | "between";
  attribute?: string;
  values: any[];
}

interface FlagVariant {
  key: string;
  weight: number;
  value: any;
}

interface EvaluationContext {
  userId?: string;
// ... (詳細な実装についてはリファレンスガイドを参照)

Reference Guides

references/ ディレクトリの詳細な実装:

ガイド	内容
Feature Flag Service (TypeScript)	Feature Flag Service (TypeScript)
React Hook for Feature Flags	React Hook for Feature Flags
Feature Flag with Analytics	Feature Flag with Analytics
LaunchDarkly-Style SDK	LaunchDarkly-Style SDK
Admin UI for Feature Flags	Admin UI for Feature Flags

Best Practices

✅ すべき事

• わかりやすいフラグ名を使用する
• フラグの目的とライフサイクルを文書化する
• 段階的なロールアウトを実装する
• フラグの評価を追跡する
• 古いフラグを定期的にクリーンアップする
• 実験にフィーチャーフラグを使用する
• 重要な機能のキルスイッチを実装する
• 有効・無効の両方の状態をテストする
• 安定したロールアウトのため一貫性のあるハッシング処理を使用する
• 非技術ユーザー向けの管理 UI を提供する

❌ してはいけない事

• フラグを永続的な設定に使用する
• 古いフラグで技術的負債を蓄積させる
• フラグのクリーンアップをスキップする
• フラグを細かく分割しすぎる
• フラグのチェックをあちこちにハードコーディングする
• 分析とモニタリングをスキップする