1. Flipper 도입 배경과 피처 플래그의 가치
피처 플래그는 새로운 코드를 배포한 후 실제 활성화 시점은 나중에 결정할 수 있게 해주는 제어 장치입니다. 이는 특정 사용자 그룹, 트래픽 비율, 혹은 특정 조건에 따라 실시간으로 기능을 켜고 끌 수 있게 합니다. StackBlitz는 기존의 인하우스 솔루션을 사용하고 있었으나, 제품 성장에 따라 점진적 롤아웃, 분석 도구 연동, 감사 로그 등의 고도화된 기능이 필요해졌고, 이에 따라 확장성이 뛰어난 Flipper Gem을 채택하게 되었습니다.
2. 인간 친화적인 식별자 활용 (Friendly IDs)
기본적으로 Flipper는 User;42와 같은 데이터베이스 식별자를 사용합니다. 하지만 관리자 입장에서는 @username이나 이메일 주소로 기능을 활성화하는 것이 훨씬 직관적입니다. 이를 위해 Flipper::Actor 클래스를 패치하여 입력된 식별자가 사용자 이름인지, 이메일인지, 혹은 조직의 슬러그(slug)인지 판단하고 적절한 모델 인스턴스를 찾아 flipper_id를 반환하도록 개선했습니다. 또한 Flipper::UI 설정을 통해 플레이스홀더를 변경함으로써 관리자가 어떤 형식을 입력해야 하는지 명확히 안내할 수 있습니다.
3. 팀 및 조직 단위의 그룹 활성화
피처 플래그는 대개 개별 사용자 단위로 체크되지만, 비즈니스 요구사항에 따라 특정 ‘팀’ 전체에 기능을 열어줘야 할 때가 있습니다. Flipper의 커스텀 그룹 등록 기능을 활용하면, 체크 대상이 되는 actor가 특정 조직의 멤버인지 동적으로 확인하는 로직을 구현할 수 있습니다. 예를 들어 organization_members라는 그룹을 정의하고, 해당 그룹에 특정 조직을 추가하면 그 조직에 속한 모든 사용자가 별도의 설정 없이도 해당 기능을 사용할 수 있게 됩니다.
4. 분석 시스템 연동 및 관찰 시점 기록
A/B 테스트나 기능 성과 분석을 위해서는 사용자가 기능을 ‘언제 처음 보았는지’가 중요합니다. 단순히 플래그가 켜진 시점이 아니라, 실제 코드 경로를 통해 enabled? 메서드가 호출되어 사용자가 해당 기능을 접한 순간을 기록해야 합니다. 이를 위해 ActiveSupport::Notifications를 구독하여 feature_operation.flipper 이벤트를 추적합니다. 데이터베이스에 flipper_remembers 테이블을 구축하여 각 사용자별 최초 노출 시점을 기록하고, 새로운 기록이 생성될 때만 분석 엔진(Analytics Tracker)으로 이벤트를 전송하여 데이터 전송량을 최적화합니다.
5. 관리자 작업 감사 로그(Audit Log) 구현
Flipper UI는 독립적인 Rack 애플리케이션으로 동작하기 때문에 Rails의 current_user에 직접 접근할 수 없습니다. 이를 해결하기 위해 커스텀 Rack 미들웨어를 작성하여 Warden(Devise의 기반) 세션에서 사용자 정보를 추출하고 CurrentAttributes에 저장합니다. 이후 Flipper의 작업을 구독하는 이벤트 핸들러에서 이 정보를 활용해 ‘누가’, ‘언제’, ‘어떤 플래그’를 변경했는지 상세한 감사 로그를 남깁니다. 또한 텍스트 프래그먼트 URI 기술을 활용해 감사 로그에서 해당 피처 플래그 설정 페이지로 직접 연결되는 링크를 제공하여 관리 편의성을 극대화했습니다.