Motor de Produtividade Pessoal · PWA offline-first · Manual atualizado para a versão v16 (10/11/2026)
Aplicativo: https://magpe-stack.github.io/Impulso/
Código-fonte: https://github.com/magpe-stack/Impulso
Manual: https://github.com/magpe-stack/Impulso/blob/main/README.md
Este manual foi atualizado a partir do README fornecido e confrontado com os arquivos locais da versão v16 (
app.js,index.html,styles.css,sw.jsemanifest.json). As funcionalidades descritas refletem o código disponível, não testes certificados em todos os dispositivos. O Impulso não substitui um sistema oficial de controle de jornada trabalhista.
- Apresentação e conceito
- Requisitos e instalação
- Primeiro acesso e navegação
- Projetos
- Meu Dia e registro de ponto
- Entrada manual retroativa
- Hábitos
- Histórico e exclusões
- Radar do Tempo e maestria
- Arena de 100 Chefões
- Backup e restauração
- Impressão e relatórios
- Tema, tela cheia e rodapé
- Como o tempo é calculado
- Armazenamento, privacidade e funcionamento offline
- Solução de problemas
- Perguntas frequentes
- Limitações e cuidados
- Estrutura técnica do projeto
- Glossário e roteiro de verificação
O Impulso é um aplicativo pessoal para registrar períodos de atividade, organizar hábitos e visualizar o avanço de projetos. Seu nome representa o movimento inicial que transforma uma intenção em ação, seguido da constância necessária para construir resultados.
O sistema reúne oito áreas: Início, Ponto, Meus Projetos, Meu Dia, Hábitos, Histórico, Arena de Chefões e Radar do Tempo. Cada projeto possui registros, hábitos e progresso próprios. O painel de maestria usa a meta simbólica de 10.000 horas; essa quantidade não é garantia científica de domínio de qualquer habilidade.
A gamificação da Arena transforma minutos e conclusões registrados em dano contra adversários. Ela é um recurso motivacional, não uma medida de qualidade do trabalho.
- Acesse https://magpe-stack.github.io/Impulso/.
- Aguarde o carregamento inicial com conexão à internet.
- Verifique se a página inicial e os comandos estão disponíveis.
- Faça um registro de teste, use Exportar para salvar o projeto individual e Backup Geral para salvar todos os projetos.
O aplicativo foi construído com HTML, CSS e JavaScript nativos. Não exige conta, senha, servidor de dados nem assinatura.
Em navegadores compatíveis, procure a opção Instalar aplicativo, Adicionar à tela inicial ou equivalente no menu do navegador. A disponibilidade varia conforme navegador, sistema e critérios de instalação. A instalação não é obrigatória para usar o Impulso.
No computador, um navegador compatível pode oferecer um ícone de instalação na barra de endereço. No Android, o menu do Chrome pode oferecer a instalação ou um atalho para a tela inicial.
Depois de um carregamento bem-sucedido, o Service Worker tenta armazenar os arquivos essenciais para acessos sem conexão. A disponibilidade offline depende de o cache ter sido instalado corretamente e de o navegador não o ter removido. Teste o acesso em modo avião antes de depender dele.
A identidade atual usa o foguete vermelho. O splash apresenta o foguete imóvel sobre fundo branco, um anel circular de progresso que avança durante aproximadamente 4 segundos e a revelação gradual do nome IMPULSO e do subtítulo Motor de Produtividade Pessoal. O preenchimento do anel e a revelação são controlados pelo JavaScript, e não apenas por animações CSS.
Os ícones de instalação atuais são rocket-192-v11.png e rocket-512-v11.png, referenciados em manifest.json. O ícone da tela inicial do Android pode continuar antigo após uma atualização, porque o sistema operacional mantém recursos da instalação anterior. Faça backup antes de desinstalar; se necessário, reinstale o PWA após publicar e confirmar os novos arquivos. Não confunda o ícone instalado com o logotipo exibido dentro do aplicativo.
Na primeira utilização, a página Início oferece o botão + Novo Projeto. Sem projeto ativo, os módulos dependentes de projeto não exibem dados operacionais.
No celular e no computador, o botão ☰ (menu hambúrguer) no canto superior esquerdo abre o painel de navegação e ferramentas. O logotipo do foguete no cabeçalho leva ao início. No menu estão também Novo Projeto, Registrar Ponto, Entrada Manual, Backup Geral, Restaurar Backup, Imprimir, Alternar tema, Tela cheia, Sobre e os links do projeto.
A navegação principal apresenta:
| Área | Finalidade |
|---|---|
| Início | Resumo do projeto ativo e atalhos |
| Ponto | Iniciar, acompanhar e terminar trabalhos cronometrados |
| Meus Projetos | Criar, abrir, renomear, excluir e imprimir projetos |
| Meu Dia | Consultar registros organizados por dia e seus totais |
| Hábitos | Criar hábitos e confirmar execuções |
| Histórico | Consultar os registros do projeto |
| Arena de Chefões | Acompanhar os 100 adversários e o dano acumulado |
| Radar do Tempo | Visualizar o ciclo angular e a meta de 10.000 horas |
O projeto ativo é aquele selecionado mais recentemente ou criado por último. A seleção é mantida no armazenamento local.
- Clique em + Novo Projeto.
- Digite o nome, com no máximo 50 caracteres.
- Selecione Criar projeto.
O sistema registra automaticamente a data e a hora da criação. O novo projeto passa a ser o ativo, com lista de registros e hábitos inicialmente vazia.
Acesse Meus Projetos e clique em Abrir no projeto desejado. As informações de Meu Dia, Hábitos, Histórico, Arena e Radar passam a corresponder ao projeto selecionado.
Em Meus Projetos, selecione Renomear, informe o novo nome (até 50 caracteres) e confirme em Salvar. Os registros permanecem associados ao mesmo projeto.
Clique na lixeira do projeto e confirme. A exclusão elimina o projeto inteiro, inclusive seus registros, hábitos e progresso. Não há lixeira de recuperação nem desfazer; um backup anterior pode permitir restaurar dados, mas a restauração substitui o conjunto atual.
O botão Imprimir lista gera uma apresentação imprimível com nome, data de criação e tempo acumulado de cada projeto.
A página Ponto possui um painel próprio, integrado à navegação, sem janela modal bloqueante.
- Abra Ponto pelo menu ou pelo botão de atalho.
- No campo Nome do trabalho, informe o que será realizado (até 50 caracteres).
- Clique em Iniciar. O aplicativo grava automaticamente a data e a hora de início.
- Continue trabalhando. Você pode visitar outras páginas do Impulso ou fechar e reabrir o aplicativo no mesmo navegador: o início fica salvo no armazenamento local.
- Retorne à página Ponto e clique em Terminar e salvar. Confirme a ação.
- O aplicativo registra a data e a hora de término e lança automaticamente a atividade no Histórico e no Meu Dia.
Enquanto o trabalho está aberto, o painel mostra o nome, o horário inicial e um contador de duração. A contagem é calculada pela diferença entre horários, e não pela quantidade de atualizações visuais; por isso, a duração pode ser recuperada quando o aplicativo volta a ser aberto. O trabalho não é encerrado automaticamente quando a página é fechada.
Não é necessário clicar em um terceiro botão Concluir: na versão atual, Terminar e salvar encerra e grava a atividade. Um botão adicional de gravação só aparece para recuperar sessões encerradas em versões anteriores.
O Ponto suporta naturalmente trabalhos que começam em um dia e terminam no seguinte. Exemplo:
| Campo | Valor |
|---|---|
| Nome | Desenvolvimento do aplicativo |
| Início | 10/11/2026 — 23:00 |
| Término | 11/11/2026 — 01:00 |
| Duração | 2 horas |
A atividade permanece em uma única linha, associada à data em que começou. O cálculo dos totais diários divide o tempo pelo calendário: nesse exemplo, 1 hora no dia 10 e 1 hora no dia 11.
Meu Dia organiza as atividades do projeto em cartões intitulados Meu Dia DD-MM-AAAA. Cada atividade aparece no cartão de sua data de início. Os cartões podem ser ordenados dos mais antigos aos mais recentes ou vice-versa.
As colunas são exatamente Atividade | Nome | Início | Término | 🗑, nessa ordem. Os tipos de atividade são Ponto, Hábito e Entrada Manual. O campo Nome exibe o nome do trabalho ou do hábito, e os horários apresentam data e hora completas.
O total trabalhado de cada dia considera a parte de todos os intervalos que realmente ocorreu naquela data, inclusive quando uma atividade começou no dia anterior. Por isso, um dia pode ter tempo contabilizado mesmo sem possuir uma atividade iniciada nele.
A lixeira exclui o registro, após confirmação, e recalcula os totais e a Arena. Não há desfazer.
A Entrada Manual serve para registrar um trabalho que já aconteceu, sem usar o cronômetro do Ponto. Seu formulário é independente.
- Abra Entrada Manual pelo menu ou pelos atalhos.
- Informe a data (dia, mês e ano).
- Digite o nome da atividade, com até 50 caracteres.
- Selecione as horas e os minutos de início e término.
- Clique em Lançar entrada.
O formulário atual não possui campo Observação. O nome informado aparece na coluna Nome, e a coluna Atividade exibe Entrada Manual.
Limitação importante: o formulário manual atual exige início e término na mesma data e não permite um término futuro. Para trabalhos que cruzam a meia-noite, use o Ponto em tempo real ou faça lançamentos manuais separados por dia. Os horários manuais têm precisão de minutos.
O aplicativo impede um intervalo manual cujo término não seja posterior ao início. Não há edição direta: para corrigir, exclua o registro incorreto e crie outro.
A lista de hábitos começa vazia em cada projeto.
- Abra Hábitos.
- Clique em + Criar hábito.
- Informe o nome, com até 50 caracteres.
- Defina a duração estipulada em minutos, de 1 a 1.440.
- Confirme em Criar hábito.
Cada hábito possui um Pomodoro com contador regressivo e barra de progresso. Os controles permitem Iniciar, Pausar, Retomar, Concluir e Reiniciar, conforme o estado do cronômetro.
- Clique em Iniciar para começar a contar o tempo.
- Use Pausar e Retomar quando necessário.
- Clique em Concluir e confirme para registrar o tempo efetivamente executado. O sistema guarda os segmentos de execução, excluindo os períodos de pausa.
- Use Reiniciar para descartar a sessão de Pomodoro em andamento, após confirmação.
A execução concluída aparece em Meu Dia e no Histórico, com Hábito na coluna Atividade e o nome cadastrado na coluna Nome. A contagem de tempo combina intervalos sobrepostos para evitar dupla contabilização com os registros de ponto. O contador depende do relógio do dispositivo e da execução do aplicativo; não é um cronômetro de precisão metrológica.
Observação técnica: o código também mantém uma rotina interna de conclusão retroativa de hábitos, mas a interface principal atual apresenta os controles do Pomodoro.
Clique na lixeira ao lado do hábito. A definição do hábito é excluída, mas as execuções já registradas permanecem no histórico e nas métricas até serem excluídas individualmente. Não há comando para editar um hábito já criado; exclua-o e crie outro com a configuração desejada.
O Histórico reúne todos os registros do projeto ativo desde sua criação, independentemente do dia, ordenados do mais recente ao mais antigo.
O Histórico e o Meu Dia utilizam as mesmas colunas, nesta ordem:
| Atividade | Nome | Início | Término | 🗑 |
|---|---|---|---|---|
| Ponto | Desenvolvimento | 10/11/2026 23:00 | 11/11/2026 01:00 | 🗑 |
| Hábito | Leitura | 11/11/2026 09:00 | 11/11/2026 09:30 | 🗑 |
| Entrada Manual | Revisão | 11/11/2026 10:00 | 11/11/2026 11:00 | 🗑 |
Os dados acima são exemplos ilustrativos.
- Atividade: apenas Ponto, Hábito ou Entrada Manual.
- Nome: o nome cadastrado no respectivo formulário, limitado a 50 caracteres.
- Início e Término: datas e horários completos; registros antigos incompletos podem exibir um traço.
- Lixeira: remove a atividade, após confirmação, e recalcula as métricas.
Compatibilidade histórica: pares antigos de eventos Início/Término são apresentados juntos quando o aplicativo encontra um par correspondente. Um evento antigo sem par permanece visível, sem inventar o horário ausente. A exclusão de um par antigo remove os dois eventos associados.
A diferença essencial é que Histórico mostra todos os dias em uma lista única, enquanto Meu Dia separa os registros por data de início.
O Radar Espacial do Tempo representa o tempo contabilizado do projeto em ciclos de uma hora:
| Tempo no ciclo | Ângulo |
|---|---|
| 15 minutos | 90° |
| 30 minutos | 180° |
| 45 minutos | 270° |
| 60 minutos | 360° — ciclo completo |
No anel externo, a fórmula atual é 1 grau a cada 10 segundos (6 graus por minuto). No anel interno, o ponteiro percorre 60 segundos por volta. Ao completar uma hora o indicador angular externo retorna a 0° para iniciar o próximo ciclo, enquanto o tempo acumulado continua aumentando no indicador Tempo total. Portanto, 60 minutos aparecem como 0° no novo ciclo, não como um arco permanente de 360°.
O módulo também exibe o tempo total, a meta de 10.000 horas, as horas restantes e o percentual de maestria. A meta é calculada por projeto, sem somar outros projetos.
A Arena possui 100 adversários, começando pela Sentinela das Cinzas e terminando no Arquichefão do Impulso. Os 50 adversários originais foram mantidos; outros 50 foram adicionados. Cada projeto possui sua própria Arena.
A progressão está distribuída ao longo de 10.000 horas de trabalho efetivamente acumuladas. Cada minuto equivale a 1 HP de dano. Os chefões têm resistências progressivamente maiores, e o último é derrotado ao alcançar 600.000 minutos (10.000 horas). Não há bônus de dano por simplesmente encerrar uma atividade, pois isso anteciparia a meta.
Os tempos sobrepostos são contabilizados uma única vez, conforme a regra de tempo acumulado do projeto. A Arena mostra o adversário atual, sua barra de resistência, o total de chefões derrotados e os 100 níveis com os respectivos limites em horas.
Atualização de versões anteriores: os registros não são modificados. Como a distribuição dos níveis mudou, o número de chefões derrotados pode ser recalculado de acordo com o tempo total do projeto. A meta de 10.000 horas permanece inalterada.
Backup Geral (menu hambúrguer): baixa um arquivo JSON com todos os projetos e seus registros, hábitos, sessões e identificação do projeto ativo. Exemplo: impulso-backup-10-11-2026.json. Use esta opção para proteger ou transferir o conjunto completo de dados.
Exportar (página inicial e páginas do projeto): baixa um JSON contendo somente o projeto ativo, incluindo seus registros, hábitos e sessões. Exemplo: impulso-projeto-meu-livro-10-11-2026.json. Antes de exportar, abra o projeto desejado. Se não houver projeto ativo, o aplicativo solicitará que você abra um.
Os arquivos individuais usam a identificação kind: "project" e guardam o projeto em project. Não são backups gerais: para recuperá-los, use Importar, ao lado de Exportar. O comando Restaurar Backup aceita apenas backups gerais.
As exportações contêm datas e horários dos registros, mas não criam documentos separados de Meu Dia. O tema visual não é incluído, pois fica em outra chave de armazenamento local.
- Na página inicial, clique em ⬆ Importar, ao lado de ⬇ Exportar.
- Selecione um arquivo
.jsonproduzido por Exportar. - Confirme a importação. O projeto será acrescentado aos projetos existentes e se tornará o projeto ativo.
- Caso o arquivo já tenha sido importado, uma nova cópia independente será criada, sem sobrescrever o projeto existente.
Importar não apaga outros projetos e não aceita arquivos de Backup Geral. A importação conserva os registros, hábitos e sessões presentes no arquivo. Verifique a integridade do arquivo antes de importar; o limite é de 40 MB.
- Abra o menu Hambúrguer (☰) e clique em Restaurar Backup. Esse comando fica disponível exclusivamente no menu, não nas páginas do aplicativo.
- Escolha um arquivo JSON criado por Backup Geral (não por Exportar).
- Leia a confirmação.
- Confirme somente se deseja substituir os dados atuais.
A restauração substitui todos os projetos existentes; não mescla dados. Apenas arquivos produzidos por Backup Geral podem ser restaurados. Arquivos de Exportar contêm somente um projeto e são rejeitados por este comando. O arquivo é submetido a verificações básicas de estrutura e tamanho (limite de 40 MB). Arquivos de outros aplicativos ou formatos incompatíveis são recusados.
Faça backup ao final de sessões importantes e antes de limpar dados do navegador, trocar de aparelho, restaurar arquivos ou atualizar o software. Guarde cópias fora do próprio navegador, preferencialmente em dois locais independentes. Verifique periodicamente se o arquivo foi baixado corretamente.
O JSON não é criptografado. Quem tiver acesso ao arquivo poderá ler os nomes, datas e observações registrados.
Em Meu Dia ou no menu, use Imprimir para abrir a impressão do projeto ativo. O relatório contém o nome do projeto, a data de emissão, indicadores de tempo, hábitos, chefões e progresso, além de cartões Meu Dia DD-MM-AAAA.
As tabelas impressas usam Atividade | Nome | Início | Término, sem lixeira (exclusão não se aplica ao papel). A apresentação de Meu Dia e Histórico na tela acrescenta a lixeira como quinta coluna.
A impressão é realizada pelo próprio navegador. É possível selecionar uma impressora ou Salvar como PDF, quando essa opção estiver disponível. O Impulso não gera PDF nativamente.
Em Meus Projetos, o comando Imprimir lista apresenta nomes, datas de criação e tempo acumulado dos projetos. A paginação final depende do navegador e das configurações de papel, escala e margens.
Abra o menu hambúrguer e use ◐ Alternar tema para alternar entre os modos. O tema claro é o padrão na primeira utilização; a escolha fica guardada no navegador.
A identidade cromática usa cores vermelhas, rosas e alaranjadas derivadas do estudo Itten. A aparência efetiva depende das regras do styles.css e da renderização do navegador.
O botão ⛶ Tela cheia, no menu hambúrguer, solicita o modo de tela cheia. O navegador pode bloquear a operação ou não disponibilizá-la, especialmente em alguns dispositivos móveis. Use o mesmo botão ou o comando do sistema para sair.
O menu hambúrguer apresenta os links para o PWA oficial, o repositório GitHub, o Manual e o botão Sobre, que explica o significado do nome Impulso e alerta sobre a necessidade de backups.
Cada novo registro de Ponto salvo contém início e término automáticos. Uma Entrada Manual contém o intervalo informado pelo usuário. Uma execução de Hábito registra os intervalos de execução do Pomodoro.
Para compatibilidade, o código também interpreta pares antigos de eventos de ponto (start/end). Um início antigo sem término não entra no total consolidado; a duração de um Ponto atual em andamento pode aparecer nos indicadores ao vivo.
Os intervalos válidos são combinados antes de calcular o total, evitando contar duas vezes o mesmo período.
Exemplo: Ponto das 10h às 11h e Hábito das 10h30 às 11h representam 1 hora total, não 1h30. Pausas do Pomodoro não são incluídas nos segmentos efetivamente trabalhados.
Um trabalho iniciado às 23h30 e terminado às 00h30 dura 1 hora, mas contribui com 30 minutos para cada dia civil. A atividade completa aparece no cartão de Meu Dia correspondente à data de início, com os dois horários.
O Ponto usa os horários do relógio do dispositivo, com precisão interna em milissegundos; o cronômetro apresenta segundos. A Entrada Manual seleciona horas e minutos. Os totais exibidos em horas/minutos descartam os segundos residuais na apresentação. O dano da Arena considera minutos inteiros efetivamente acumulados.
A versão v16 continua guardando o estado dos projetos em localStorage, na chave impulso-data-v1. A preferência visual fica na chave impulso-theme. Não há IndexedDB implementado nesta versão.
Os dados não são enviados pelo código do aplicativo a uma API de sincronização. O site é hospedado no GitHub Pages, e o navegador realiza requisições normais para obter seus arquivos. Links externos do rodapé abrem seus respectivos destinos.
Na versão v16, o Service Worker usa o cache impulso-v16-arena-100. Para navegação, tenta a rede e recorre ao HTML em cache quando necessário; para outros recursos locais, prioriza a cópia em cache quando existente. O cache de arquivos não é o mesmo que o armazenamento dos projetos.
Riscos: limpar os dados do site, usar navegação privada, trocar de navegador/aparelho, desinstalar com remoção dos dados, atingir limites de armazenamento ou sofrer falha do dispositivo pode provocar perda de informações. Não existe sincronização automática entre dispositivos.
| Sintoma | Causa possível | O que fazer |
|---|---|---|
| Página 404 | Arquivo ou caminho incorreto no GitHub Pages | Confira a URL, a publicação e a presença de index.html na raiz |
| Tela presa no splash | Erro de JavaScript ou versão antiga em cache | Recarregue, abra o console do navegador e confira se app.js foi publicado corretamente; faça backup antes de limpar dados |
| Registrar Ponto ou Entrada Manual abre Novo Projeto | Pode haver arquivos antigos misturados ou cache desatualizado | Publique index.html, app.js, styles.css, manifest.json, sw.js e os ícones compatíveis; confira os comandos em janela atualizada e preserve o backup antes de limpar dados |
| Ícone antigo no Android | O atalho instalado conserva o ícone anterior | Confira o manifesto e os PNG do foguete; faça backup antes de reinstalar o PWA |
| Splash sem anel ou sem revelação | HTML, CSS e JS de versões diferentes ou erro de script | Confira o anel SVG no index.html, a rotina startSplash() no app.js e as requisições de recursos |
| Novo Projeto não responde | Falha de script ou elemento de interface ausente | Verifique o console, index.html e app.js; teste em aba normal atualizada |
| Dados sumiram | Limpeza ou troca de armazenamento/perfil | Procure backup JSON; não há recuperação automática |
| Total de horas menor que o esperado | Ponto ainda em andamento, intervalos sobrepostos ou dados antigos incompletos | Revise o Ponto e o Histórico |
| Total inesperado após entrada retroativa | Registro duplicado ou sequência cronológica inconsistente | Revise datas, horas e tipos; exclua e recrie o lançamento incorreto |
| Ponto parece não estar contando | Projeto ativo diferente ou sessão não iniciada | Abra a página Ponto do projeto correto e confira o horário inicial |
| Pomodoro não avança em segundo plano | Restrições de execução do navegador ou aplicativo suspenso | Mantenha o aplicativo aberto durante o uso e confira o registro ao concluir |
| Instalação PWA não aparece | Critérios do navegador ou configuração da publicação | Abra via HTTPS, verifique manifest e Service Worker, e use o navegador compatível |
| Não abre offline | Cache inicial incompleto ou removido | Conecte à internet, carregue novamente e teste antes de desconectar |
| Importação recusada | JSON incompatível, inválido ou acima de 40 MB | Selecione um backup exportado pela versão compatível do Impulso |
| Impressão com aparência diferente | Motor de impressão ou opções de papel/margem | Ajuste escala, orientação e margens na visualização de impressão |
| Tela cheia indisponível | Restrição do navegador | Use o aplicativo na janela normal ou instalado como PWA |
- Exporte um backup, se o aplicativo ainda permitir.
- Verifique se os arquivos
index.html,styles.css,app.js,sw.js,manifest.jsone os ícones foram publicados corretamente. - Abra as ferramentas do desenvolvedor e consulte Console para erros de JavaScript e Network/Rede para falhas de carregamento.
- Teste a atualização da página com conexão ativa.
- Só considere limpar armazenamento/cache após confirmar que possui backup recuperável.
Preciso de internet para registrar ponto?
Não, desde que os arquivos necessários estejam disponíveis no navegador e o aplicativo abra corretamente offline.
Os projetos compartilham horas?
Não. Cada projeto tem registros e progresso independentes.
O tempo continua aumentando enquanto um Ponto está aberto?
Sim, o painel de Ponto e os indicadores ao vivo usam o horário de início salvo. O total consolidado dos relatórios considera os intervalos encerrados e salvos.
Posso lançar registros de meses anteriores?
Sim, pela Entrada Manual, respeitando a validação de datas e horários. Para atravessar a meia-noite em um único registro, use o Ponto.
Posso editar um registro?
Não diretamente nesta versão. Exclua e lance novamente.
O botão de lixeira existe em todos os registros?
Há lixeira para projetos, definições de hábitos e registros de ponto/hábitos exibidos em Meu Dia e Histórico. A exclusão não é reversível no aplicativo.
Apagar a definição de um hábito apaga suas execuções?
Não. As execuções anteriores permanecem até serem removidas individualmente.
O backup contém todos os projetos?
Backup Geral, sim. Exportar contém apenas o projeto ativo. Importar aceita o arquivo individual e adiciona um projeto sem apagar os demais. Restaurar Backup aceita apenas o Backup Geral e substitui o conjunto completo existente.
O backup contém as preferências de tema?
Não. O tema é armazenado separadamente.
Posso compartilhar dados entre celular e computador automaticamente?
Não. Para transferir, exporte um backup em um dispositivo e restaure no outro, lembrando que a restauração substitui os dados de destino.
10.000 horas garantem maestria?
Não. É uma referência motivacional, não uma certificação de competência.
A versão descrita neste manual possui limitações relevantes:
- Sem sincronização em nuvem ou conta de usuário.
- Sem edição direta de registros ou hábitos já cadastrados.
- Pomodoro local: existe cronômetro com pausa e retomada, mas não há garantia de execução ininterrupta em segundo plano ou de precisão absoluta.
- Compatibilidade com pontos antigos: pares de eventos antigos são agrupados quando possível; registros sem par podem aparecer incompletos.
- Entrada Manual em um único dia: o formulário atual não permite informar uma data de término diferente da data de início.
- Sem desfazer exclusões nem mesclagem de backups.
- Sem garantia de armazenamento permanente pelo navegador.
- Sem PDF nativo: a exportação em PDF depende da impressão do navegador.
- Sem comprovação de conformidade WCAG por auditoria automatizada e manual; a paleta e os estilos devem ser testados em dispositivos reais.
- Sem garantia de execução ou homologação em todos os navegadores; a publicação exige testes funcionais.
Para registros de jornada com finalidade jurídica, trabalhista ou contratual, verifique as exigências legais aplicáveis e use um sistema apropriado. O Impulso foi concebido como ferramenta pessoal de organização.
Impulso/
├── index.html # Estrutura, navegação e elementos-base
├── styles.css # Aparência, responsividade e impressão
├── app.js # Estado, registros, hábitos, Arena e relatórios
├── sw.js # Cache offline de recursos
├── manifest.json # Metadados de instalação do PWA
├── rocket-192-v11.png # Ícone do foguete, 192 × 192
├── rocket-512-v11.png # Ícone do foguete, 512 × 512
├── logo.png # Foguete do splash
├── logo.svg # Foguete do cabeçalho
└── README.md # Este manual
A aplicação é executada inteiramente no navegador. O código usa localStorage, crypto.randomUUID quando disponível, <dialog>, Blob, FileReader, SVG, a API de impressão e a API de Service Worker. Algumas funcionalidades dependem do suporte do navegador.
O armazenamento JSON usa o campo version: 1. Alterações futuras no formato dos dados devem considerar migrações e compatibilidade de backups.
Projeto ativo: projeto cujos dados aparecem nos módulos operacionais.
Ponto: atividade cronometrada com início automático e término automático ao salvar.
Intervalo: duração entre um início e um término válidos.
Entrada Manual: atividade cadastrada posteriormente com data e horários informados pelo usuário.
Hábito: atividade recorrente definida com duração estipulada.
HP: pontos de vida de um chefão.
Dano: pontos de progresso derivados dos registros.
Radar: representação angular do tempo dentro de um ciclo de 60 minutos.
PWA: aplicação web que pode oferecer instalação e funcionamento offline.
Backup Geral: cópia JSON de todos os projetos, compatível com Restaurar Backup.
Exportar: cópia JSON somente do projeto ativo, recuperável pelo botão Importar.
Importar: acrescenta um projeto individual aos projetos existentes, sem substituí-los.
- Abrir o site sem erro e concluir a tela inicial.
- Criar um projeto com nome válido.
- Criar outro projeto e confirmar que os dados ficam separados.
- Abrir Ponto, informar o nome do trabalho e clicar em Iniciar.
- Navegar por outras páginas e retornar ao Ponto sem perder a sessão.
- Clicar em Terminar e salvar e conferir início e término no Histórico e Meu Dia.
- Testar um Ponto atravessando a meia-noite, conferindo a divisão dos totais diários.
- Criar uma Entrada Manual com nome e intervalo no mesmo dia e conferir o total.
- Criar e concluir um hábito e verificar Meu Dia e Histórico.
- Conferir o radar, a Arena e o progresso do projeto.
- Excluir um registro de teste e verificar o recálculo.
- Exportar um projeto individual e confirmar que o JSON contém somente o projeto ativo.
- Importar o JSON individual e confirmar que o projeto é acrescentado sem apagar os demais.
- Criar um Backup Geral e confirmar que o JSON contém todos os projetos.
- Restaurar um backup de teste, sabendo que substituirá os dados atuais.
- Abrir a impressão do projeto e da lista de projetos.
- Confirmar que Ponto abre sua página própria e Entrada Manual abre o formulário correspondente, nunca Novo Projeto.
- Verificar o anel de progresso e a revelação do nome no splash de 4 segundos.
- Conferir o foguete como ícone de instalação no Android, com backup prévio se for reinstalar.
- Testar o Pomodoro (iniciar, pausar, retomar, concluir e reiniciar).
- Testar o tema claro/escuro e a tela cheia.
- Verificar a abertura offline após o primeiro carregamento completo.
- Verificar o comportamento em celular e computador.
Impulso — Motor de Produtividade Pessoal
O progresso nasce da ação, ganha força na constância e se revela no tempo.
Manual revisado para a atualização v16. Antes de atualizar ou reinstalar o aplicativo, preserve uma cópia de seus dados.