Se você leva café a sério, sabe que o conjunto de equipamentos, grãos e águas que você usa é a alma de cada extração. O Coffee Codex foi projetado para te dar controle absoluto sobre esse ecossistema. Neste artigo, vamos mergulhar em tudo que a tela de Setup oferece e como ela se conecta com o resto do app.
Uma Vitrine Organizada por Categorias
A tela de Setup não é uma lista qualquer. Ela organiza seus itens em prateleiras (shelves) que você pode reordenar com drag & drop, com feedback háptico e animações bouncy. Cada prateleira representa uma categoria de equipamento ou insumo:
| Categoria | O que guarda |
|---|---|
| Moedor | Moedores manuais e elétricos, com perfis de calibração |
| Método | Mais de 35 métodos (V60, Aeropress, Chemex, French Press…) |
| Chaleira | Chaleiras tradicionais e bico de ganso |
| Balança | Balanças de precisão |
| Espresso | Máquinas e acessórios de espresso |
| Filtro | Filtros de papel, pano, metal |
| Acessório | Qualquer outro item (WDT, distribuidor, etc.) |
| Cafés | Seus grãos com controle de inventário |
| Águas | Águas envasadas com perfil mineral e estoque |
Cada item é exibido em um card quadrado com ícone específico. O Coffee Codex tem um mapeamento de mais de 80 ícones individuais para equipamentos específicos — sua V60 vai aparecer com o ícone da V60, não um ícone genérico.
Itens Padrão e Gerenciamento
Você pode marcar qualquer equipamento como padrão (default) — um ícone de alfinete aparece no canto indicando qual é seu moedor do dia a dia, seu método favorito, etc. Itens não editáveis ou vazios aparecem com opacidade reduzida, deixando claro o que está pronto para uso.
Adicionar Sempre ao Alcance
Cada prateleira tem um botão "+" persistente no final. Prateleiras vazias mostram um card centralizado convidando você a adicionar o primeiro item. Ao tocar, você é levado à tela de cadastro específica para aquela categoria:
- Equipamentos: Um assistente de multi-seleção com um catálogo completo. Você escolhe seu modelo entre dezenas de opções pré-cadastradas.
- Cafés: Cadastro completo com origem, variedade, processamento, torra, nota SCA, perfil de sabor, datas de torra/compra/abertura.
- Águas: Perfil mineral completo (pH, dureza, alcalinidade, sódio, TDS).
Controle de Inventário Integrado
Uma das features mais poderosas: Cafés e Águas têm controle de estoque nativo. Você define o estoque inicial (gramas para café, ml para água), o limite de estoque baixo (alerta quando está acabando) e o débito automático (após cada brew log, o estoque é debitado automaticamente).
Após cada preparo, se o estoque cair abaixo do limite, o Coffee Codex exibe um alerta de estoque baixo; e com um toque você vai direto para a tela de reabastecimento.
Débito automático disponível no plano BARISTAReordenação com Estilo
As prateleiras são reordenáveis por drag & drop com animação de escala (1.0 → 1.08x ao arrastar), elevação de sombra (2dp → 8dp), spring animations (bouncy damping), feedback háptico no início, durante e no fim do arrasto, e persistência — a ordem é salva e restaurada entre sessões.
Detalhamento Profundo
Cada item no setup abre uma tela de detalhes rica. Equipamentos têm modos DISPLAY, ADD, EDIT, campos editáveis flexíveis (via EditableField com tipo de teclado configurável) e metadados como marca, modelo, data de aquisição, preço, loja, material e cor.
Moedores
Calibração por cliques com presets para modelos reais (Comandante C40, 1Zpresso JX-Pro, Baratza Encore, Niche Zero) e mapeamento de níveis de moagem (Extrafina → Extragrossa) para micras e cliques.
Métodos
Mais de 35 métodos catalogados com ícones individuais, cada um com suas particularidades de preparo.
Cafés
Perfil completo: torra, variedade, processamento, altitude, nota SCA. Datas de torra, compra, abertura e validade. Inventário com alertas de estoque baixo.
Águas
Perfil mineral completo: pH, dureza, alcalinidade, sódio, TDS. Origem, volume, preço. Inventário com alertas.
Integração com o Resto do App
O Setup é a porta de entrada para todo o ecossistema Coffee Codex:
- Setup → Detalhes → Edição
- Setup → Criação de Receita (via BottomSheet)
- Setup → Brew Log (com débito automático de estoque)
Ao selecionar um método no setup, ele alimenta os dados do playbook — a seção onde você armazena e descobre novas receitas. A água e o café selecionados viram ingredientes no brew timer. Tudo conectado.
Sincronização Multi-dispositivo
Os dados do setup são armazenados localmente com Room e sincronizados com Firestore usando um padrão offline-first (SyncState: SYNCED, DIRTY, DELETED). Isso significa que funciona completamente offline, sincroniza quando a conexão volta, e seus equipamentos, cafés e águas ficam disponíveis em qualquer dispositivo.
Controle por Nível de Acesso
O Coffee Codex respeita diferentes níveis de acesso:
| Funcionalidade | FREE | BARISTA (Premium) |
|---|---|---|
| Cadastro de equipamentos | Ilimitado | Ilimitado |
| Cadastro de cafés | 1 café | Ilimitado |
| Cadastro de águas | 1 água | Ilimitado |
| Cadastro de moedores | 1 moedor | Ilimitado |
| Débito automático de inventário | ||
| Dados salvos localmente | ||
| Sincronização em nuvem |
FREE vs BARISTA
O plano FREE oferece acesso básico ao setup: permite o cadastro de um café, uma água e um moedor, com os demais equipamentos ilimitados e dados sempre salvos localmente. O plano BARISTA desbloqueia acesso completo, incluindo débito automático de inventário e dados salvos na nuvem.
Experiência Visual
A UI do setup usa Material 3 com tema customizado (AppTheme), animações fluidas, sombras e transições. Cada card é um quadrado com proporção 1:1, ideal para navegação por toque. A largura se adapta dinamicamente à tela do dispositivo.
O setup do Coffee Codex não é apenas uma lista de equipamentos — é o centro de comando da sua jornada cafeeira. Comece configurando seu moedor, adicione seu método favorito, cadastre aquele café especial que você comprou, e deixe o app cuidar do resto.
Perguntas Frequentes
Baixe o Coffee Codex gratuitamente
Monte sua cafeteria pessoal com o setup mais completo para café especial. Disponível na Google Play.
Baixar Coffee Codex