---
name: QFila Cliente — fluxo QR + signup
description: App cliente lê QR da empresa no primeiro uso para vincular o estabelecimento, depois guarda localmente
type: project
originSessionId: d63a7891-0622-4f67-8342-41e4ba10ac6e
---
Fluxo do QFila Cliente:

1. **Primeiro uso:** splash → tela de leitura de QR code (cada empresa tem seu QR único)
2. QR contém o `establishment_code` (e opcionalmente URL tipo `https://qfila.com.br/e/{code}`)
3. Após ler o QR, formulário de cadastro: **nome, telefone, senha**
4. Cadastro cria a conta vinculada àquele estabelecimento
5. App grava em `SharedPreferences` o establishment_code + dados da empresa + credenciais
6. **Usos subsequentes:** já entra direto (ou pede só senha) — não pergunta mais QR. App fica "casado" com aquela empresa.

**Why:** Cada estabelecimento tem seu próprio QFila Cliente conceitualmente — o usuário escolhe uma empresa e o app vira "o app daquela empresa". Não é marketplace.

**How to apply:**
- Pacote para QR: `mobile_scanner`.
- Persistir `establishment_code`, `establishment_name`, `establishment_logo` em SharedPreferences com chaves `est_code`, `est_name`, etc.
- Adicionar permissão `CAMERA` no `android/app/src/main/AndroidManifest.xml` (não só no debug — ver `feedback_flutter_android_internet`).
- Rota `/qr-setup` antes de `/login`; lógica do splash decide.