Skip to content
sjollenbeckPublic

About

TodoList Pro - Sistema de Gerenciamento de Tarefas Pessoais

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

5 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 

Repository files navigation

📋 TodoList Pro

Sistema completo de gerenciamento de tarefas com recursos avançados, interface moderna e intuitiva.

Version License Status

🌟 Visão Geral

TodoList Pro é uma aplicação web moderna para gerenciamento de tarefas pessoais e profissionais. Desenvolvido com tecnologias web puras (HTML, CSS, JavaScript) e Alpine.js, oferece uma experiência rica sem necessidade de instalação.

✨ Destaques

  • ✅ 100% Offline - Funciona sem internet usando IndexedDB
  • 🎨 Interface Moderna - Design limpo com Bootstrap 5
  • 🌙 Tema Escuro - Alternância automática entre claro/escuro
  • 📊 Dashboard Completo - Visualização em tempo real
  • 🔔 Notificações Inteligentes - Sistema proprietário de lembretes
  • 💾 Backup/Restore - Exporte e importe seus dados facilmente

🚀 Começando

Requisitos

  • Navegador moderno (Chrome, Firefox, Edge, Safari)
  • Nenhuma instalação necessária!

Instalação

  1. Clone ou baixe o repositório:

    git clone https://github.com/seu-usuario/omni-tdl.git
    cd omni-tdl
  2. Abra o arquivo:

    index.html
    

    Ou use um servidor local:

    # Python
    python -m http.server 8000
    
    # Node.js
    npx serve
  3. Acesse:

    http://localhost:8000
    

📚 Recursos Principais

1. 📝 Gerenciamento de Tarefas

Campos Disponíveis:

  • Nome - Título da tarefa (obrigatório)
  • Descrição - Detalhes adicionais
  • Status - Nova, Em Andamento, Pausada, Cancelada, Concluída
  • Categoria - Organização por projetos/áreas
  • Clientes - Múltipla seleção com tags visuais
  • Prioridade - Escala de 1 a 10
  • Datas:
    • Data/Hora de Início
    • Data/Hora de Término
    • Previsão de Entrega
  • Subtarefas - Checklist interno com drag-and-drop

Funcionalidades:

  • 🔍 Busca em tempo real por nome ou descrição
  • 🎯 Filtros avançados por status, categoria e cliente
  • 📊 Indicadores visuais com círculos coloridos por status
  • ⏱️ Tempo decorrido calculado automaticamente
  • ✅ Validação inteligente - Tarefa só pode ser concluída se todas subtarefas estiverem completas

2. 📂 Categorias

Organize suas tarefas por projetos, áreas ou contextos:

  • Nome personalizado
  • Cor customizável - Identificação visual rápida
  • Ícones - Biblioteca completa Bootstrap Icons
  • Prioridade - Ordenação automática

Exemplos de uso:

  • 💼 Trabalho
  • 🏠 Pessoal
  • 🎯 Projetos
  • 📚 Estudos

3. 👥 Clientes

Gerencie relacionamentos e atribuições:

  • Nome e descrição
  • Prioridade
  • Vinculação múltipla - Uma tarefa pode ter vários clientes
  • Exibição em tags - Visual clean e organizado

4. ✅ Sistema de Subtarefas

Divida tarefas complexas em etapas menores:

Recursos:

  • ➕ Adicionar - Nome e descrição opcional
  • ☑️ Checkbox interativo - Marca/desmarca com um clique
  • 🟰 Drag-and-Drop - Reordene arrastando
  • 🗑️ Remover - Exclusão individual
  • 📊 Barra de progresso - Visualização do avanço (0% a 100%)

Exemplo Prático:

Tarefa: Fazer Pão
├─ ☑ Separar farinha
├─ ☑ Preparar ambiente
├─ ☐ Misturar ingredientes
├─ ☐ Ligar forno
└─ ☐ Assar por 40min

Progresso: 2/5 concluídas [████░░░░░░] 40%

Regra de Validação:

⚠️ Uma tarefa só pode ser marcada como concluída se todas as subtarefas estiverem completas.


📊 Dashboard e Relatórios

Dashboard de Tarefas

Visualização completa em formato de tabela com:

📈 Contadores no Topo:

  • Total de Tarefas
  • 🔵 Novas
  • 🟡 Em Andamento
  • 🟢 Concluídas
  • ✅ No Prazo
  • ⚠️ Atrasadas

📋 Tabela Detalhada:

Categoria Status Tarefa Previsão SLA/Progresso Clientes
AiOAgent 🟡 Em Andamento VCRM... 05/10/2025 [████████░░] 80% - Restam 1d Cliente A

Barra de Progresso SLA:

  • 🟢 Verde (0-79%) - Tempo tranquilo
  • 🟡 Amarelo (80-99%) - Atenção! Prazo apertado
  • 🔴 Vermelho (100%+) - Atrasado!

Recursos:

  • 📄 Copiar - Texto formatado para área de transferência
  • 🖨️ Imprimir - Layout otimizado para impressão/PDF

Status Report

Relatório textual formatado para compartilhamento:

📅 STATUS REPORT - 05/10/2025
==================================================

📊 TOTAL DE TAREFAS: 15

🔵 NOVAS (3)
--------------------------------------------------
1. Nome da Tarefa
   📁 Categoria: Desenvolvimento
   ⭐ Prioridade: 8
   👥 Clientes: Cliente A, Cliente B
   📝 Descrição...

🟡 EM ANDAMENTO (5)
--------------------------------------------------
...

🟢 CONCLUÍDAS (7)
--------------------------------------------------
...

Funcionalidades:

  • 📋 Copiar para área de transferência
  • 🖨️ Imprimir/Salvar como PDF
  • 📧 Compartilhar por email/chat
  • 📑 Agrupa por status automaticamente

🔔 Sistema de Notificações

Sistema proprietário (não usa notificações do navegador) com popup elegante no canto inferior direito.

Como Funciona

  1. Configuração: Configurações → 🔔 Notificações
  2. Ativar: Toggle switch para ligar/desligar
  3. Intervalo: Defina de quanto em quanto tempo deseja ser notificado (1 a 1440 minutos)
  4. Filtros:
    • Selecione quais status deseja receber notificações
    • Selecione quais categorias deseja monitorar
  5. Automático: Sistema notifica sobre tarefas com entrega prevista para hoje

Características

  • 🎯 Inteligente - Só notifica tarefas relevantes
  • ⏰ Periódico - Intervalo configurável
  • 🎨 Visual - Design bonito e discreto
  • 🔕 Controle total - Ative/desative quando quiser
  • 📱 Não intrusivo - Auto-fecha em 15 segundos

Exemplo de Notificação

┌────────────────────────────────────┐
│ 🔔 📅 Tarefas para Hoje        [X] │
│                                    │
│ 3 tarefas com entrega prevista:   │
│                                    │
│ • VCRM - Adicionar Contato         │
│   AiOAgent                         │
│                                    │
│ • Ajustes Flow eFacil              │
│   eFacil                           │
│                                    │
│ ... e mais 1 tarefa                │
│                                    │
│                    [Ver Tarefas]   │
└────────────────────────────────────┘

⚙️ Configurações

👤 Perfil

Personalize suas informações:

  • Nome completo
  • Email
  • Empresa/Organização

Dados salvos localmente e incluídos nos backups.

💾 Backup / Restore

Fazer Backup

  • 📥 Exportar todos os dados em formato JSON
  • Inclui: tarefas, categorias, clientes, perfil, subtarefas
  • Nome automático: todolist-backup-YYYY-MM-DD.json

Restaurar Backup

  • 📤 Importar arquivo JSON anterior
  • ⚠️ Confirmação dupla para segurança
  • Substitui todos os dados atuais
  • Recarrega automaticamente após restauração

🚨 Zona de Perigo

  • 🗑️ Limpar todos os dados permanentemente
  • Dupla confirmação obrigatória
  • Não pode ser desfeito
  • Recomendação: Faça backup antes!

🎨 Interface e Usabilidade

Temas

Alternância fácil entre tema claro e escuro:

  • 🌞 Claro - Padrão, ideal para ambientes iluminados
  • 🌙 Escuro - Confortável para trabalho noturno
  • Botão no canto superior direito
  • Preferência salva automaticamente

Indicadores Visuais

Status com Círculos Coloridos:

  • 🔵 Nova
  • 🟡 Em Andamento
  • ⏸️ Pausada
  • 🔴 Cancelada
  • 🟢 Concluída

Cards de Tarefas:

  • Borda colorida por categoria
  • Badge de status com indicador
  • Badge de prioridade
  • Indicador de subtarefas (quando houver)
  • Tempo decorrido
  • Datas formatadas

Responsividade

  • 📱 Mobile - Layout adaptável
  • 💻 Desktop - Aproveitamento total da tela
  • 📊 Dashboard - Modal fullscreen para visualização máxima

🛠️ Tecnologias Utilizadas

Tecnologia Versão Uso
HTML5 - Estrutura
CSS3 - Estilos e animações
JavaScript (ES6+) - Lógica da aplicação
Alpine.js 3.13.3 Reatividade
Bootstrap 5.3.2 Framework CSS
Bootstrap Icons 1.11.1 Ícones
IndexedDB - Persistência offline

Arquitetura

assets/
├── css/
│   └── style.css          # Estilos customizados
├── js/
│   ├── models/
│   │   ├── Task.js        # Modelo de Tarefa
│   │   ├── Subtask.js     # Modelo de Subtarefa
│   │   ├── Category.js    # Modelo de Categoria
│   │   └── Client.js      # Modelo de Cliente
│   ├── services/
│   │   ├── TaskService.js      # CRUD de Tarefas
│   │   ├── CategoryService.js  # CRUD de Categorias
│   │   └── ClientService.js    # CRUD de Clientes
│   ├── logger.js          # Sistema de logs
│   ├── storage.js         # Gerenciador IndexedDB
│   └── app.js             # Aplicação principal
└── index.html             # Página única

Princípios de Design:

  • ✅ SOLID - Código organizado e manutenível
  • ✅ Single Responsibility - Cada classe tem uma responsabilidade
  • ✅ DRY - Não repetir código
  • ✅ Clean Code - Legível e bem documentado

📖 Guia de Uso Rápido

Primeiros Passos

  1. Crie Categorias:

    • Menu lateral → Categorias
    • Clique em "Nova Categoria"
    • Defina nome, cor e ícone
    • Salve
  2. Adicione Clientes (opcional):

    • Menu lateral → Clientes
    • Clique em "Novo Cliente"
    • Preencha os dados
    • Salve
  3. Crie sua Primeira Tarefa:

    • Menu lateral → Tarefas
    • Clique em "Nova Tarefa"
    • Preencha:
      • Nome (obrigatório)
      • Categoria (obrigatório)
      • Status
      • Previsão de Entrega (padrão: hoje)
    • Adicione subtarefas se necessário
    • Salve

Gerenciando Subtarefas

  1. Ao criar/editar uma tarefa:

    • Role até a seção "Subtarefas"
    • Digite nome e descrição
    • Clique em "Adicionar"
    • Arraste pela alça 🟰 para reordenar
    • Marque ☑️ quando concluída
  2. Regra Importante:

    ⚠️ Só é possível marcar a tarefa como "Concluída" quando todas as subtarefas estiverem completas.

Usando Filtros

Na tela de Tarefas:

  • 🔍 Busca - Digite palavras-chave
  • 📊 Status - Filtre por Nova, Em Andamento, etc.
  • 📁 Categoria - Selecione uma categoria específica
  • ❌ Limpar - Remove todos os filtros

Dashboard e Relatórios

Dashboard

  1. Clique em "📊 Dashboard"
  2. Visualize:
    • Contadores por status
    • Tarefas no prazo vs atrasadas
    • Tabela completa ordenada
    • Barras de SLA para tarefas em andamento
  3. Use botões para:
    • 📋 Copiar (texto formatado)
    • 🖨️ Imprimir (layout otimizado)

Status Report

  1. Clique em "📄 Status Report"
  2. Veja relatório consolidado por status
  3. Use botões para:
    • 📋 Copiar (compartilhar por email/chat)
    • 🖨️ Imprimir (documentação)

Configurando Notificações

  1. Acesse: ⚙️ Configurações → 🔔 Notificações
  2. Ative o toggle "Ativar Notificações"
  3. Configure:
    • Intervalo: 30 minutos (padrão)
    • Status: Selecione quais deseja monitorar
    • Categorias: Escolha categorias específicas (vazio = todas)
  4. Teste: Clique em "🔔 Testar Notificação"
  5. Salve as configurações

Como funciona:

  • Sistema verifica tarefas com entrega prevista para hoje
  • Aplica filtros de status e categoria
  • Exibe popup elegante no canto inferior direito
  • Repete automaticamente no intervalo configurado

Backup e Segurança

Fazer Backup Regular

⚙️ Configurações → 💾 Backup/Restore → 📥 Baixar Backup

Recomendação: Faça backup semanal ou antes de mudanças grandes.

Restaurar Backup

⚙️ Configurações → 💾 Backup/Restore → 📤 Restaurar Backup
  1. Selecione arquivo .json
  2. Confirme a ação (dados atuais serão substituídos)
  3. Aguarde restauração automática

💡 Dicas de Produtividade

Organize com Cores

Use cores de categorias estrategicamente:

  • 🔴 Vermelho - Urgente/Crítico
  • 🟡 Amarelo - Atenção necessária
  • 🔵 Azul - Tarefas normais
  • 🟢 Verde - Baixa prioridade
  • 🟣 Roxo - Projetos especiais

Use Prioridades

Escala 1-10:

  • 10 - Máxima urgência
  • 5 - Prioridade média (padrão)
  • 1 - Pode aguardar

Tarefas são automaticamente ordenadas por prioridade!

Aproveite as Subtarefas

Ideal para:

  • ✅ Tarefas complexas com múltiplas etapas
  • ✅ Checklists de processos
  • ✅ Fluxos de trabalho sequenciais
  • ✅ Controle de qualidade

Exemplo real:

Tarefa: Deploy da Aplicação
├─ ☑ Executar testes
├─ ☑ Build de produção
├─ ☐ Upload para servidor
├─ ☐ Verificar logs
└─ ☐ Notificar equipe

Monitore com Dashboard

Rotina sugerida:

  1. Manhã: Abra o Dashboard para visão geral do dia
  2. Identifique: Tarefas próximas do prazo (barra amarela/vermelha)
  3. Priorize: Foque nas atrasadas primeiro
  4. Acompanhe: Verifique progresso durante o dia

Configure Notificações Inteligentes

Cenário 1 - Trabalho Focado:

Intervalo: 120 minutos (2h)
Status: Em Andamento
Categorias: Trabalho, Projetos

Cenário 2 - Controle Geral:

Intervalo: 30 minutos
Status: Nova, Em Andamento, Pausada
Categorias: Todas (deixar vazio)

🔒 Privacidade e Dados

Onde Seus Dados Ficam?

  • 💾 IndexedDB - Banco de dados local do navegador
  • 🏠 localStorage - Configurações e preferências
  • 🚫 Nenhum servidor externo - 100% local

Segurança

  • ✅ Dados nunca saem do seu computador
  • ✅ Sem rastreamento ou analytics
  • ✅ Sem conexão com internet necessária
  • ✅ Você tem controle total

Backup Recomendado

Salve seus backups em:

  • ☁️ Google Drive / OneDrive / Dropbox
  • 💾 Pendrive ou HD externo
  • 📧 Envie por email para você mesmo

🎯 Casos de Uso

Freelancer

Categorias: Cliente A, Cliente B, Administrativo
Clientes: Cadastro por projeto
Dashboard: Visão de entregas por cliente
Notificações: Ativas, intervalo 60min

Desenvolvedor

Categorias: Frontend, Backend, DevOps, Bugs
Subtarefas: Checklist de código review
Dashboard: Acompanhamento de sprints
Status Report: Para daily meetings

Gerente de Projetos

Categorias: Por projeto/equipe
Clientes: Stakeholders
Dashboard: Visão consolidada de prazos
Backup: Semanal para documentação

Estudante

Categorias: Por matéria
Subtarefas: Tópicos de estudo
Prioridade: Por prazo de entrega
Notificações: Lembretes de prazos

🐛 Solução de Problemas

Notificações não aparecem

Verifique:

  1. ✅ Toggle "Ativar Notificações" está ligado?
  2. ✅ Existem tarefas com entrega prevista para hoje?
  3. ✅ Filtros de status/categoria não estão muito restritivos?
  4. ✅ Clique em "Testar Notificação" para forçar

Dados não aparecem após restaurar backup

Solução:

  • Recarregue a página (Ctrl+R ou F5)
  • Verifique se o arquivo JSON está válido
  • Olhe o console (F12) para erros

Tarefa não marca como concluída

Causa comum: Subtarefas pendentes

  • Abra a tarefa
  • Role até "Subtarefas"
  • Marque todas como concluídas (☑️)
  • Tente novamente

Performance lenta

Otimizações:

  • Use filtros para reduzir tarefas exibidas
  • Conclua e arquive tarefas antigas
  • Faça backup e limpe dados antigos periodicamente

🔄 Atualizações e Versões

v1.0.0 - Versão Atual

Recursos Principais:

  • ✅ CRUD completo de Tarefas, Categorias e Clientes
  • ✅ Sistema de Subtarefas com drag-and-drop
  • ✅ Dashboard com SLA e métricas
  • ✅ Status Report exportável
  • ✅ Sistema de Notificações proprietário
  • ✅ Backup/Restore completo
  • ✅ Temas claro e escuro
  • ✅ Persistência IndexedDB

🤝 Suporte e Contribuições

Encontrou um Bug?

  1. Abra o console (F12)
  2. Procure por mensagens de erro em vermelho
  3. Anote os passos para reproduzir
  4. Crie uma issue no GitHub

Sugestões de Melhoria

Envie suas ideias! Estamos sempre melhorando.


📜 Licença

Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.


🎓 Créditos

Desenvolvido com:

  • ❤️ Paixão por produtividade
  • ☕ Muito café
  • 🎵 Boa música

Bibliotecas de terceiros:


📞 Contato

TodoList Pro - Sistema de Gerenciamento de Tarefas

Feito com 💜 para aumentar sua produtividade!


About

TodoList Pro - Sistema de Gerenciamento de Tarefas Pessoais

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages