stable · overview · 0.1.0

Feature Flags & Configuration

Project Backend 本地評估

MiniCenter 發布 immutable、遞增 version 的 client-scoped snapshot。Snapshot 包含 Feature Flags、allowlisted non-secret configuration 與 Secret Manager resource references；Project Backend 負責 cache 並在本地評估，不應為每個 request 同步呼叫 MiniCenter。

每個 Feature Flag 同時包含 enabled 與明確 safe_default。Flag 不能代表 authorization、付費 Entitlement 或立即 security revocation，因為 cache 與 change notification 允許 bounded propagation delay。

從讀取、cache 與評估開始，再閱讀change notification 與 secret reference。

Guides

• 讀取、cache 與評估 — 以 ETag 取得最新 configuration version，cache 300 秒並在 outage 使用 safe default。
• Change notification 與 secret reference — 以 configuration.version.published invalidation cache，並安全解析 Secret Manager reference。

API Reference

• Get the latest Feature Flag and Configuration version — GET /api/v1/feature-configuration

Event Reference

• Configuration version published — A new immutable Feature Flag and Configuration version is available for a Project Client.