Manual do Docco

0. Sobre este app

O Docco é um app de gerenciamento de armazenamento para smartphone que registra com fotos onde você guardou algo e o que é, para que você possa encontrar depois usando a busca. O slogan é "~ Pare de perder tempo procurando ~".

Uma estrutura simples de dois níveis

Os dados do Docco são organizados em apenas dois níveis: "Locais" e "Itens". Não há pastas aninhadas.

Seus dados ficam salvos no seu próprio Google Drive

O Docco não tem servidor próprio. Tanto os dados quanto as fotos são salvos em uma pasta Docco dentro do Google Drive da conta com a qual você faz login. O desenvolvedor não consegue ver seus dados. Se você trocar de celular, basta fazer login com a mesma conta do Google para continuar de onde parou.

Requisitos

Gesto comum: deslize para baixo para fechar um modal

Ao adicionar ou editar um local de armazenamento ou item, editar categorias, escolher o idioma ou abrir qualquer outra tela que sobe de baixo, você também pode fechá-la deslizando a alça no topo para baixo com o dedo. Assim como ao tocar fora do modal, o que você digitou não é salvo.

1. Primeira inicialização

Na primeira vez que você abre o app, verá "Seleção de idioma → tutorial de 3 telas → login", nessa ordem. Isso não aparece novamente depois da primeira vez.

Navegando pelo tutorial

• Use o botão Continuar na parte de baixo, ou deslize para a esquerda ou direita para trocar de tela.
• O botão de voltar do Android também leva você para a tela anterior.

Instalação de itens de exemplo

• Ao escolher Instalar itens de exemplo, logo após o login são criados automaticamente um local "Armário" e 6 itens dentro dele (todos com foto). São dados de exemplo para você experimentar o app, e você pode excluí-los normalmente quando não precisar mais.
• Ao escolher Começar com tela vazia, você começa sem nada registrado.

Login

1. Toque em Entrar com o Google.
2. A tela de seleção de conta do Google aparece — escolha a conta que quer usar.
3. Você será solicitado a conceder acesso ao Google Drive — permita (essa permissão só dá acesso aos arquivos que o Docco criou).
4. Quando o login terminar, a tela inicial aparece.

2. Tela inicial

2.1 Estrutura da tela

2.2 Adicionar um local de armazenamento

1. Toque em + Adicionar local na tela inicial.
2. Toque na área da foto para abrir a câmera e fotografar o local de armazenamento inteiro (isso pode ser pulado e adicionado depois).
3. Digite o nome do local (ex.: "Gaveta da cozinha, lado direito" ou "Prateleira da sala, parte de cima"). O nome é obrigatório — você não consegue tocar em Adicionar até digitá-lo.
4. Toque no campo categoria para escolher uma classificação. Se a que você quer não estiver na lista, crie na hora com + Adicionar categoria.
5. Toque em Adicionar para salvar — o local é adicionado à lista de cartões na tela inicial.

2.3 Alterar a ordem

2.4 Menu de pressionar e segurar e exclusão

Pressionar e segurar um cartão por cerca de 0,5 segundo abre o menu (mover o dedo mais de 8px cancela isso e inicia um arraste para reordenar).

Fluxo de confirmação ao excluir um local

• A terceira etapa oferece três opções: Voltar / Manter fotos / Excluir tudo.
• Ao escolher Manter fotos, o local some do app, mas os arquivos de foto permanecem no Google Drive.
• Mesmo escolhendo Excluir tudo, as fotos são apenas movidas para a lixeira do Google Drive — não são apagadas imediatamente. Se algo for excluído por engano, dá para restaurar pela lixeira do Drive.
• Se nem o local nem nenhum de seus itens tiver foto, a terceira etapa é pulada e a exclusão termina na etapa 2.

2.5 Menu de configurações

Abre pelo ícone de engrenagem no canto superior direito do cabeçalho. Toque fora do menu para fechá-lo.

3. Tela de detalhes do local

3.1 Estrutura da tela

3.2 Alterando nome, foto e categoria

3.3 Adicionar um item

Sugestões de tags frequentes

Abaixo do campo de tags, aparecem até 12 chips com as tags mais usadas por você, em ordem de frequência. Toque para adicionar direto ao campo, o que evita inconsistências, como digitar "papelaria" uma vez e "material de escritório" em outra para a mesma coisa. Tags já digitadas não aparecem como sugestão.

3.4 Editar, mover e excluir itens

Fluxo de confirmação ao excluir um item

Para um item sem foto, a segunda etapa é pulada e a exclusão termina na etapa 1.

3.5 Reordenar itens

Assim como na tela inicial, você pode trocar entre PersonalizadoData de adiçãoA–Z com três botões. Só na ordem Personalizado é possível arrastar a alça ≡ na borda direita da linha para mudar sua posição. Os três botões da barra de ordenação só aparecem com 2 ou mais itens.

4. Câmera e fotos

Elementos da tela

Como escolher a qualidade

Como diz o aviso no rodapé da tela, use qualidade baixa para coisas que só precisam ser reconhecidas, e qualidade alta quando também quiser ler texto na foto.

Quando a câmera não está disponível

• Se a permissão foi negada: "Permissão de câmera necessária" é exibido. Siga as instruções na tela: vá em Configurações › Aplicativos › Docco › Permissões › Câmera e ative "Permitir", depois toque em Tentar novamente.
• Se a própria API de câmera não estiver disponível: "Câmera não disponível. Selecione um arquivo de foto." é exibido, e a tela muda para 📁 Selecionar arquivo, para escolher da galeria.

5. Pesquisa

6. Gerenciamento de categorias (tipos de local)

Como abrir

Tela de detalhes do local → selo de categoria na parte inferior esquerda da foto → Editar categorias...

O que você pode fazer

As categorias padrão em português são Sala, Cozinha e Armário, num total de 3. Você também pode adicionar uma nova na hora, no seletor de categoria exibido ao adicionar um local (veja 2.2).

7. Trocar de idioma

Troque em Tela inicial → ícone de engrenagem → 🌐 Português / Language. O app inteiro muda no instante em que você escolhe um idioma, e sua escolha fica salva no aparelho.

8. Solução de problemas

Apareceu "A sessão expirou"

Por segurança, a conexão entre Google e Docco expira após cerca de 1 hora. Ao detectar a expiração, um aviso de reconexão aparece sobreposto à tela.

• Tocar em Reconectar ao Google leva você pela tela de login do Google e volta a exatamente onde você estava.
• O que você estava digitando é preservado. O aviso de reconexão só se sobrepõe ao modal aberto — a tela por baixo nunca é fechada.
• Em casos raros, tocar em Reconectar ao Google não responde, mas mesmo assim ele se restabelece automaticamente em cerca de 15 segundos, permitindo tocar de novo.

Lista de mensagens de erro

Os erros aparecem como um aviso na parte de cima da tela e somem sozinhos após 5 segundos (tocar neles também os fecha na hora).

Outros

• Sair da conta não apaga seus dados. Eles continuam na pasta Docco do Google Drive, então fazer login de novo com a mesma conta traz tudo de volta.
• Fotos excluídas por engano podem ser restauradas pela lixeira do Google Drive (o Docco nunca faz exclusão permanente). No entanto, a ligação do app entre a foto e o item é perdida, então depois de restaurar você precisará associá-la de novo.
• O botão de voltar do Android retrocede na ordem modal → tela anterior → tela inicial; ao pressionar de novo na tela inicial, o app é fechado. Pequenas janelas, como o menu de configurações, o seletor de idioma e o seletor de categoria, fecham sozinhas, sem sair da tela atual.

9. Atualizações do app

Se você instalou o app pelo Google Play, quando uma nova versão é publicada o download começa automaticamente em segundo plano enquanto você usa o app. Quando fica pronto, um aviso aparece na parte de baixo da tela.