View audit log of feature flag changes for my organization

The feature flag admin screen includes an audit log section or dedicated history view showing all flag change events for the organization. Each log entry records the flag key, previous state, new state, rollout percentage if applicable, the administrator who made the change, and a UTC timestamp. The log is read-only and paginated. Entries are stored in the feature-flag-repository alongside the flag configuration and are scoped by organization RLS policies to ensure cross-organization data isolation.

MEDIUM story-organization-scoped-feature-flags-organization-admin-005 5 pts

Story Points

Medium

Priority

Organization-scoped Feature Flags

Feature

User Story

As a Organization Administrator

I want to view a history of all feature flag changes made within my organization, including who made the change and when

So that I can understand the timeline of feature activations, diagnose unexpected behavior reported by peer mentors, and maintain accountability for configuration decisions

Acceptance Criteria

Given I am on the feature flag admin screen, when I navigate to the audit log section, then I see a chronologically ordered list of all flag change events for my organization
Given the audit log is displayed, when I view an entry, then I can see the flag name, old state, new state, changed-by administrator name, and timestamp
Given the audit log has more than 20 entries, when I scroll to the bottom of the visible list, then older entries are loaded via pagination
Given I am an administrator of Organization A, when I view the audit log, then I only see entries belonging to Organization A and no entries from other organizations
Given a flag change was made 30 days ago, when I view the audit log, then the entry is still visible and the timestamp is displayed in local time with timezone indicator
Given no flag changes have been made in my organization, when I view the audit log, then an empty state message is shown explaining that no changes have been recorded yet

Business Value

Audit logs are essential for Bufdir compliance and organizational accountability. When a peer mentor reports that a feature disappeared or behaved unexpectedly, administrators need a reliable trail to determine if a configuration change caused the issue. This also builds administrator confidence in making flag changes, knowing all actions are traceable and reversible.

Components

Organization-scoped Feature Flags

Related Feature

Organization Administrator

User Role