![[ICO]](/icons/blank.gif){kind=icon}
![[PARENTDIR]](/icons/back.gif){kind=icon}
![[TXT]](/icons/text.gif){kind=icon}
Feature Flags Overview
VoiceAssist uses a comprehensive feature flag system for runtime feature management, A/B testing, and gradual rollouts.
Quick Reference
| Category | Purpose | Examples |
|---|---|---|
ui | Frontend/UX features | ui.dark_mode, ui.new_navigation |
backend | API/Server features | backend.rag_strategy, backend.rbac_enforcement |
admin | Admin panel features | admin.bulk_operations, admin.analytics |
integration | External services | integration.nextcloud, integration.openai |
experiment | A/B tests | experiment.experimental_api |
ops | Operational controls | ops.maintenance_mode, ops.rate_limiting |
Naming Convention
All flags follow the pattern: <category>.<feature_name>
// Good examples ui.dark_mode; backend.rag_strategy; ops.maintenance_mode; // Bad examples darkMode; // Missing category ui - dark - mode; // Wrong separator ff_ui_dark_mode; // Old deprecated pattern
Architecture
┌─────────────────┐ ┌──────────────────┐ ┌──────────────┐
│ Application │────▶│ Feature Flag │────▶│ PostgreSQL │
│ │ │ Service │ │ (persist) │
└─────────────────┘ └──────────────────┘ └──────────────┘
│
▼
┌──────────────┐
│ Redis │
│ (5min TTL) │
└──────────────┘
Related Documentation
- Naming Conventions
- Lifecycle Management
- Advanced Types
- Multi-Environment
- Admin Panel Guide
- Best Practices
API Endpoints
| Endpoint | Method | Description |
|---|---|---|
/api/admin/feature-flags | GET | List all flags |
/api/admin/feature-flags/{name} | GET | Get specific flag |
/api/admin/feature-flags | POST | Create flag |
/api/admin/feature-flags/{name} | PATCH | Update flag |
/api/admin/feature-flags/{name} | DELETE | Delete flag |
/api/admin/feature-flags/{name}/toggle | POST | Toggle boolean flag |