Remote Config

packages/aivaleu_core/lib/src/services/remote_config_service.dart concentra defaults e acesso ao Firebase Remote Config.

Chaves atuais

Chave	Default	Uso
active_campaign_id	""	Campanha destacada.
campaign_theme_enabled	false	Ativa tema de campanha.
campaign_animation_enabled	false	Animações de campanha.
home_campaign_banner_enabled	false	Banner na home.
campaign_priority_mode	false	Prioridade visual de campanha.
show_campaign_hero	true	Hero de campanha.
enable_whatsapp_cta	false	CTA de WhatsApp.
enable_referral_unlock_banner	false	Banner de benefício por indicação.
premium_launch_enabled	true	Variação de apresentação/plano de lançamento.
latest_app_version_android	""	Versão Android disponível.
latest_app_version_ios	""	Versão iOS disponível.
app_changelog	{}	JSON em string por versão.

O serviço usa fetch timeout de 10 s e intervalo mínimo de 5 min. Falha de fetch é logada e os defaults permanecem disponíveis.

Limite de responsabilidade

Remote Config pode alterar apresentação, flags e versões já suportadas pelo código. Não deve ser fonte de verdade para:

• custom claims ou roles;
• cooldown;
• quota de cupons;
• aprovação/curadoria;
• pagamento/assinatura real;
• dados sensíveis;
• Firestore/Storage permissions.

Adicionando uma chave

1. declare constante em RemoteConfigService;
2. forneça default seguro em setDefaults;
3. exponha getter tipado;
4. escreva teste para fallback/comportamento relevante;
5. use a chave somente para comportamento que já possui implementação local segura;
6. atualize esta referência se a chave for operacionalmente importante.