Exemplos D2P T2E1: Exemplo de uso do app D2P - Introdução

INTRODUÇÃO

Este é o primeiro post da Série Exemplos D2P, que mostra como usar o app D2P na autogestão do processo pessoal.

O app D2P foi criado no post Dashboard de Produtividade Pessoal T1E01: Versão inicial do app gerado por IA.

O objetivo do app D2P é apoiar a autogestão de Home Office, automatizando a gerência de tarefas do processo pessoal e implementando gráfico de controle da produtividade, para gestão à vista.

Arquitetura do app D2P

O app Dashboard de Produtividade Pessoal (D2P) está implementado em arquitetura de 3 camadas,  usando Planilha Google, Apps Script e HTML.

1. Camada User Interface (UI): HTML, CSS, Javascript
   Implementação: Dashboard.html
   Função: serve para interagir com o usuário.
   
   
2. Camada Business Logic (Logic): Google Apps Script
   Implementação: Código.gs
   Função: serve para gerenciar as interações com o usuário, por meio da interface Dashboard.html, e gravar os dados na planilha "Banco de Dados - D2P".
   
   
3. Camada Database (DB): Google Sheets
   Implementação: Planilha "Banco de Dados - D2P"
   Função: serve para armazenar os dados, por meio das abas Tarefas, Defeitos, HistoricoProdutividade e XmR.
   Aba Tarefas: serve para armazenar dados das tarefas executadas.
   Aba Defeitos: serve para armazenar dados das falhas encontradas durante a execução das tarefas.
   Aba HistoricoProdutividade: serve para armazenar dados da produtividade do usuário na execução das tarefas.
   Aba XmR: serve para apresentar um gráfico de controle da produtividade, usando como fonte de dados a aba HistoricoProdutividade.
   
   

Como obter o app D2P grátis

Para obter o app D2P grátis, basta copiar os 3 arquivos abaixo e seguir as instruções no tópico Guia do Usuário, para instalação e uso do app.

Copiar "Banco de Dados - D2P"

Para copiar a planilha "Banco de Dados - D2P", clicar no link abaixo: https://docs.google.com/spreadsheets/d/1jLK2SzFiJMFBW8VY0GQoRs1Ax0TNiVrAnt_pTv-SCUg/copy

Ao clicar neste link, aparecerá uma janela conforme a figura abaixo. Clique em "Fazer uma cópia".

Copiar "Código.gs"

Para copiar o script "Código.gs", clicar no link: abaixo: 

https://docs.google.com/document/d/1ckKsTLsJNbYAbNPZ50gOBu0a3JDa12lnSMr1YUY1lv4/copy

Ao clicar neste link, aparecerá uma janela conforme a figura abaixo. Clique em "Fazer uma cópia".

Copiar "Dashboard.html"

Para copiar o HTML "Dashboard.html", clicar no link: abaixo: 

https://docs.google.com/document/d/1VwSCOedALB1DXm5uQoiQYNWP6jHlts4MzE0HGm0YK-s/copy

Ao clicar neste link, aparecerá uma janela conforme a figura abaixo. Clique em "Fazer uma cópia".

Guia do Usuário

O guia do usuário foi totalmente construído pelo Chatbot de IA do Google, Gemini 2.5 Pro, tal como a arquitetura e o código do app D2P.

Para solicitar a criação do guia do usuário, forneci dois prompts. No primeiro, esqueci de especificar as colunas das abas e uma aba adicional, portanto, fiz outro com os ajustes.

O link da conversa com o segundo prompt, que é o definitivo, é este: https://g.co/gemini/share/b98e6e7f86b7

O próximo tópico contém a mesma conversa na íntegra, portanto, o leitor pode escolher o link ou o texto. 

Guia de Instalação e Uso do Dashboard de Produtividade (D2P) - Versão Atualizada

Este guia irá te ajudar a configurar e utilizar o D2P, uma ferramenta construída com Google Apps Script e Planilhas Google para monitorar sua produtividade diária.

Parte 1: Criando Sua Cópia e Configurando o Ambiente

Siga estes passos para ter sua própria versão do dashboard funcionando.

1. Crie a Planilha a partir do Link de Cópia:
• Abra o link de cópia fornecido.
• Clique no botão "Fazer uma cópia". Isso criará uma nova planilha na sua conta do Google Drive com toda a estrutura necessária.
2. Abra o Editor de Scripts:
• Na sua nova planilha, vá ao menu e clique em Extensões > Apps Script. Uma nova aba ou janela abrirá com o editor de código.
3. Copie os Códigos para o Projeto:
• O editor de scripts já terá dois arquivos: Código.gs e Dashboard.html. Você precisa substituir o conteúdo deles.
• Arquivo Código.gs:
• Apague todo o conteúdo que já vem no arquivo Código.gs.
• Copie e cole o código do Código.gs fornecido.
• Arquivo Dashboard.html:
• No editor, clique no arquivo Dashboard.html na barra lateral esquerda.
• Apague todo o seu conteúdo.
• Copie e cole o código do Dashboard.html fornecido.
• Clique no ícone de salvar projeto (💾) no topo do editor.
4. Verifique as Abas da Planilha:
• Volte para a sua planilha. Garanta que ela possui as quatro abas com os nomes exatos abaixo:
• Tarefas
• Defeitos
• HistoricoProdutividade
• XmR
• Na aba Tarefas, crie o seguinte cabeçalho na primeira linha (da célula A1 até G1). Atenção aos nomes exatos:
• ID
• Nome
• Codigo
• Pontos
• Status
• DuracaoEfetivaSegundos
• DataConclusao
• As outras abas (Defeitos, HistoricoProdutividade, XmR) não precisam de configuração manual de cabeçalho.
5. Implante o Aplicativo Web:
• No editor do Apps Script, clique no botão azul Implantar e selecione Nova implantação.
• Clique no ícone de engrenagem (⚙️) ao lado de "Selecione o tipo" e escolha App da Web.
• Preencha as informações da seguinte forma:
• Descrição: Dashboard de Produtividade Pessoal
• Executar como: Eu (seu-email@gmail.com)
• Quem pode acessar: Qualquer pessoa com uma conta do Google (ou Apenas eu, se preferir)
• Clique em Implantar.
6. Autorize as Permissões:
• Na primeira vez, o Google pedirá sua permissão para o script acessar a planilha.
• Clique em Revisar permissões.
• Escolha sua conta do Google.
• Você verá um aviso de "O Google não verificou este app". Isso é normal. Clique em Avançado e depois em Acessar <Nome do seu projeto> (não seguro).
• Na tela seguinte, clique em Permitir.
7. Acesse seu Dashboard!
• Após a autorização, uma janela mostrará a URL do seu app da Web. Copie este link.
• Este é o link do seu dashboard! Guarde-o nos seus favoritos para acesso rápido. Toda vez que você abrir este link, seu dashboard será carregado.

---

Parte 2: Como Usar o Dashboard

O uso do D2P é dividido em três áreas principais:

📅 Jornada de Trabalho

• Iniciar Jornada: Clique neste botão para começar seu dia de trabalho. O cronômetro da "Duração Total" começará a contar.
• Finalizar Jornada: Ao final do dia, clique aqui para parar o cronômetro. Ao fazer isso, os dados consolidados do dia (produtividade, pontos totais e horas trabalhadas) serão salvos na aba HistoricoProdutividade da sua planilha.
• Nota: Você só pode finalizar a jornada se não houver nenhuma tarefa em andamento.

✅ Gerenciamento de Tarefas

1. Adicionar Tarefa: Use o formulário no "Plano do Dia" para adicionar suas tarefas, preenchendo o nome, um código (opcional) e os pontos (valor que representa o esforço/tamanho da tarefa).
2. Iniciar uma Tarefa: Na lista de tarefas, clique no ícone de "play" (▶️) ao lado de uma tarefa pendente. A tarefa aparecerá no card "Tarefa em Execução" e seu cronômetro individual começará.
• Nota: Você só pode iniciar uma tarefa se a jornada de trabalho já tiver sido iniciada.
3. Pausar/Retomar: Use o botão "Pausar" para interromper o cronômetro da tarefa. O botão mudará para "Retomar".
4. Finalizar Tarefa: Quando terminar a tarefa, clique em "Finalizar". O status da tarefa será marcado como "completed" e os dados (duração efetiva, data de conclusão, etc.) serão atualizados na aba Tarefas da planilha. Os pontos da tarefa serão somados aos "Pontos Concluídos".

⚠️ Registro de Ocorrências (Boletim de Ocorrência)

Use esta função para registrar interrupções ou problemas que afetam seu trabalho mas não são parte do tempo produtivo de uma tarefa (ex: queda de internet, problema no computador, interrupção externa).

1. Clique em "Iniciar Boletim de Ocorrência".
2. Um modal aparecerá. No final da ocorrência, preencha o Tipo de Defeito e a Descrição.
3. Clique em "Finalizar Boletim de Ocorrência".
4. A ocorrência, junto com sua duração, será registrada na aba Defeitos da sua planilha.

---

Como Criar seu Próprio Link de Cópia para Compartilhar

Se você quiser compartilhar este modelo com outras pessoas, siga os passos abaixo:

1. Abra a sua planilha (não o editor de scripts).
2. Clique no botão Compartilhar no canto superior direito.
3. Em Acesso geral, mude a permissão para Qualquer pessoa com o link e garanta que o papel esteja definido como Leitor.
4. Clique em Copiar link.
5. Você terá um link parecido com este:

https://docs.google.com/spreadsheets/d/SEU_ID_GIGANTE_AQUI/edit?usp=sharing

6. Pegue o link que você copiou e substitua a parte final edit?usp=sharing por copy.

• Antes: .../edit?usp=sharing
• Depois: .../copy

O novo link forçará qualquer pessoa que o abra a criar uma cópia da sua planilha. Compartilhe este novo link junto com as instruções acima!

CONCLUSÃO

Agora que o leitor tem o app D2P completo e o guia de instalação e uso, é hora de praticar.

Os próximos episódios desta temporada 2 da série Exemplos D2P contêm exemplos para o leitor observar e fazer adaptações para o seu processo pessoal.

Caso o leitor encontre alguma oportunidade de melhoria, há algumas alternativas para implementar as mudanças necessárias no app D2P:

1. Fazer as mudanças no app D2P, se tiver conhecimento das ferramentas Apps Script, HTML e Google Sheets, pois o código completo já foi compartilhado;
2. Escrever as especificações e solicitar as mudanças no app D2P para uma pessoa que conheça essas ferramentas;
3. Escrever as especificações e criar um Prompt para o Gemini 2.5 Pro, fornecendo os arquivos Código.gs e Dashboard.html;
4. Escrever um comentário no post em foco, descrevendo a oportunidade de melhoria. Assim, poderemos colaborar, transformando as suas necessidades em um Prompt para o Gemini 2.5 Pro.

Próximo post: Exemplos D2P T2E2: Exemplo de uso do app D2P - Lição 1