> For the complete documentation index, see [llms.txt](https://luminvs.gitbook.io/app-de-gestao-financeira/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://luminvs.gitbook.io/app-de-gestao-financeira/instalacao-e-configuracao/boas-praticas-de-utilizacao-da-aplicacao.md).

# Boas práticas de utilização da aplicação

{% embed url="<https://youtu.be/9Nh70-Oryx4>" %}

## Tutorial de Utilização do Aplicativo de Gestão Financeira com Google AppSheet

Este tutorial apresenta uma **visão geral** do aplicativo de gestão financeira desenvolvido em **Google AppSheet** e **Google Sheets**, incluindo práticas recomendadas para manutenção e compartilhamento do app.

***

### 1. Boas Práticas Iniciais

* **Aplicativos Web vs. Desktop**\
  Aplicações baseadas na Web (como Google Sheets e AppSheet) podem apresentar problemas de cache no navegador. É recomendado **limpar o cache** periodicamente para evitar erros na cópia e utilização do aplicativo.
* **Ferramenta Recomendável**
  * **CCleaner**: Software que remove arquivos temporários e dados de navegação.\
    [Baixar CCleaner](https://www.ccleaner.com/pt-br/ccleaner)
  * **Limpeza manual**: Acesse as configurações do navegador e exclua manualmente dados de cache e cookies.

***

### 2. Data Studio / Looker Studio (Google Data Locker)

Para a análise de dados mais detalhada, utiliza-se o **Looker Studio (Google Data Studio)**:

1. Acesse [lookerstudio.google.com](https://lookerstudio.google.com/).
2. Tenha em mente que relatórios, fontes de dados e gráficos estarão vinculados à sua conta Google.
3. É possível compartilhar relatórios ou torná-los públicos via **Share**.

***

### 3. Acesso ao AppSheet

1. Entre em [appsheet.com](https://www.appsheet.com/).
2. Faça login com a **mesma conta Google** que contém o aplicativo.
3. Localize o app “**app-controle-financeiro**” (ou o nome que você definiu ao copiar).
4. Clique sobre o aplicativo para abrir o editor do AppSheet.

#### 3.1 Compartilhamento do Aplicativo

* **Adicionar usuários**
  1. No editor do AppSheet, clique em **Share** (ícone de boneco no canto superior direito).
  2. Adicione o e-mail de quem terá acesso e selecione o nível de permissão (*apenas uso ou edição do app*).
* **Links de Acesso**
  1. **Link de Edição**: utilizado por quem pode alterar o aplicativo.
  2. **Link de Instalação**: a pessoa clica e instala o **container AppSheet** no celular (Android ou iOS).

> **Observação:** Mesmo para uso pessoal, o AppSheet permite até **10 usuários** simultâneos (plano gratuito).

***

### 4. Estrutura da Planilha (Google Sheets)

O aplicativo tem sua base de dados vinculada a **Google Sheets**. As principais abas são:

1. **Transações** (nome pode variar, ex.: “Contas” ou “Expenses”):
   * Registra todas as receitas e despesas, incluindo valores, datas e classificações.
   * Possui colunas automáticas para **mês** e **ano**, preenchidas por script (para não ficar arrastando fórmulas manualmente).
2. **Cartões**:
   * Lista os cartões de crédito (ex.: Nubank, BB, Santander).
   * Campos de **dia de fechamento** e **dia de vencimento** para cálculo das datas de fatura.
3. **Classe** (classificação de despesas/receitas):
   * Define categorias (por exemplo: Despesa Mensal, Receita, Casa, Escritório, etc.).
   * Quando cadastradas no AppSheet, essas categorias são refletidas nesta aba.
4. QUERY (ou aba auxiliar de consulta):
   * Normalmente com fórmulas *QUERY* para consolidar dados, efetuar agrupamentos ou filtrar informações.
   * É definida como **somente leitura** no AppSheet.

#### 4.1 Dados de Exemplo

* Ao receber o aplicativo pela primeira vez, a planilha pode vir com **linhas de exemplo** para garantir integração ao Looker Studio. Depois, você pode excluí-las e começar a inserir seus próprios dados.

***

### 5. Uso do Aplicativo (Passo a Passo)

#### 5.1 Inserir Contas (Receitas/Despesas)

1. **Acessar o aplicativo** no navegador ou celular (via AppSheet).
2. Clique em **Add** (ou ícone “+”) para inserir uma nova conta.
3. Preencha os campos principais:
   * **Conta (Banco/Cartão)**
   * **Tipo**: Despesa ou Receita
   * **Pago?** (Sim/Não)
   * **Crédito?** (Se for cartão de crédito)
   * **Data Prevista** (Data de vencimento ou recebimento)
   * **Classificação** (ex.: Despesa Mensal, Casa, Viagem etc.)
   * **Valor**
4. **Campos Adicionais**:
   * **Nota Fiscal (Scanner)**: Escaneia o QR Code da NF no celular.
   * **Imagem**: Anexa fotos de comprovantes.
   * **PDF**: Anexa boletos.
   * **Local**: Registra localização GPS (útil para abastecimentos, por exemplo).
   * **Agendar**: Integra com Google Agenda.

#### 5.2 Pagamento e Recebimento

* Para **marcar uma conta como paga** ou recebida:
  1. Selecione a conta na lista.
  2. Clique em **Pago?** = **Sim**.

> Ao pagar (ou receber), a transação sai da lista de pendências.\
> Caso precise **corrigir** a forma de pagamento, basta editar a linha (Ex.: trocar de “Crédito” para “PIX”).

#### 5.3 Parcelamento

* **Parcelas**: Ao cadastrar despesas parceladas, informe o número de parcelas. O aplicativo gerará cada parcela mensal em sequência.

***

### 6. Visão Geral e Filtros

#### 6.1 Dashboard / Gráficos

* **Resumo Financeiro**: Mostra o comparativo **Receitas vs. Despesas**.
* **Extrato Geral**: Lista todas as transações (pagas e não pagas). Possui filtros por conta, data e status (Pago ou Não Pago).

#### 6.2 Calendário Integrado

* **Calendário**: Visualiza contas a pagar/receber por dia, semana ou mês.
* Ao clicar em uma data, você vê as contas associadas àquele dia. É possível editar ou pagar diretamente.

#### 6.3 Google Agenda

* Sempre que se marca **Agendar** ao adicionar/editar uma conta, o AppSheet envia o registro para sua **Google Agenda**, gerando notificação automática no celular.

***

### 7. Integração com Looker Studio (Google Data Studio)

1. Acesse o **Looker Studio** ([lookerstudio.google.com](https://lookerstudio.google.com/)).
2. Conecte-se à mesma planilha do aplicativo (as abas de dados).
3. Explore relatórios com **gráficos e tabelas** detalhadas, usando filtragens avançadas (ex.: por período, classificação de despesa, etc.).

> **Dica**: Deixe o relatório salvo nos seus favoritos para fácil acesso diário.

***

### 8. Conclusão

Este aplicativo oferece uma solução simples para **registro de despesas e receitas**, **compartilhamento** entre usuários da mesma família e **integração** com Google Agenda e Looker Studio.

Principais benefícios:

* **Mobilidade**: Funciona no celular via AppSheet.
* **Centralização de Informações**: Planilhas, notas fiscais (QR Code), comprovantes em PDF/imagem.
* **Dashboard e Filtros**: Análise rápida do que foi pago, do que está pendente e futuras parcelas.
* **Agendamentos**: Integração gratuita com Google Agenda, recebendo alertas no celular.

Qualquer dúvida sobre personalização e funcionalidades adicionais, basta ajustar dentro do AppSheet ou entrar em contato. **Bom controle financeiro!**

***