como funciona
Guia completo de uso e documentação técnica do flow.planner.
Nenhum resultado para "".
🪼 Visão geral
O flow.planner é um planejador acadêmico PWA (Progressive Web App) voltado para estudantes universitários. Ele centraliza:
- Controle de presença em aulas com cálculo automático de frequência.
- Agenda semanal visual com suporte a eventos personalizados.
- Anotações rápidas de tarefas e tópicos de estudo.
- Arquivamento de disciplinas com histórico de frequência.
Os dados são sincronizados com a nuvem via Supabase quando o usuário está autenticado, e armazenados localmente via localStorage / IndexedDB para acesso offline.
📅 Agenda semanal
A agenda exibe uma grade horária semanal das 7h às 21h. As aulas cadastradas nas disciplinas são geradas automaticamente para todo o semestre com base no horário semanal configurado.
Navegação
- Use ‹ / › ou ← → no teclado para mudar de semana.
- O botão hoje retorna à semana atual.
- Um indicador de ping pisca no dia corrente.
- A linha vermelha indica o horário atual na semana atual.
Marcar presença
Clique em uma aula no calendário para abrir o painel de detalhes e marcar/desmarcar presença com o checkbox "marcar presença".
Criar evento
Clique em um espaço vazio na grade para abrir um menu de opções: Novo evento ou Adicionar disciplina. Eventos suportam os tipos: Lembrete, Prova/Avaliação, Entrega/Trabalho e Outro.
Mover eventos
Eventos personalizados podem ser arrastados (drag & drop) para outro horário ou dia. Solte o evento na posição desejada para reposicioná-lo. O snap é feito em intervalos de 15 minutos.
📊 Frequência por disciplina
A seção frequência por disciplina exibe cartões expansíveis com um resumo do status de cada disciplina. Clique no cabeçalho de um cartão para expandir e ver o histórico completo de aulas.
Status do cartão
| Indicador | Significado |
|---|---|
| 0h falta · 0 aulas | Frequência em dia (≥ 75%) |
| ⚠ 4h/8h · 4h restam | Em risco (≥ 75% do limite atingido) |
| ✕ reprovado · 12h/8h falta | Limite de faltas ultrapassado |
🧮 Cálculo de frequência
O flow.planner calcula frequência com base em horas, e não em número de aulas, respeitando o critério da LDB (Lei de Diretrizes e Bases da Educação, art. 24, VI):
Fórmula
Exemplo
Disciplina com 60h de carga horária total:
- Limite de faltas = ⌊60 × 0,25⌋ = 15h
- Aluno que faltou 10h → frequência = (60−10)/60 × 100 = 83,3% ✓
- Aluno que faltou 16h → frequência = (60−16)/60 × 100 = 73,3% ✕ reprovado
Estados de risco
- Em risco: horas faltadas ≥ 75% do limite (ex: faltou ≥ 11,25h de um limite de 15h).
- Reprovado: horas faltadas > limite calculado.
- Alerta crítico: ≤ 1h restante antes de reprovar. Um toast é exibido ao abrir o app.
O que é contabilizado
Apenas aulas cujo dia de realização já passou (inclusive hoje) e que não foram canceladas são incluídas no cálculo de faltas. Aulas futuras não afetam o status.
⊘ Aula cancelada
Uma aula pode ser marcada como cancelada (feriado, reposição, professor ausente, etc.). Ao cancelar uma aula:
- A aula é excluída do cálculo de frequência (nem presença nem falta são contabilizadas).
- A aula aparece riscada no calendário com o label ⊘ cancelada.
- O checkbox de presença fica desabilitado.
- A carga horária efetiva da disciplina é recalculada.
Para cancelar: clique na aula no calendário → botão "⊘ cancelar aula" no popup. Ou na seção de frequência, no botão ⊘ ao lado de cada aula na lista.
Para desfazer: clique em "↩ desfazer cancelamento" no mesmo local.
🎓 Disciplinas
Cada disciplina possui os seguintes campos:
| Campo | Descrição |
|---|---|
| Nome | Nome completo da disciplina (ex: Cálculo II) |
| Código | Identificador único (ex: MA0221). Não pode ser alterado após criação. |
| Turma | Código da turma (ex: 01) |
| Local | Sala ou bloco (ex: Bloco A – Sala 10) |
| Horários | Dia da semana + hora de início + hora de término. Múltiplos horários são suportados. |
| Início / Término | Datas do semestre letivo para aquela disciplina. |
| Cor | Cor de destaque no calendário e na seção de frequência. |
Com base nos horários e datas, o sistema gera automaticamente todas as aulas do semestre (uma por semana para cada horário configurado).
Disciplinas base vs. disciplinas do usuário
O app acompanha disciplinas pré-cadastradas (base) usadas como exemplo. Disciplinas adicionadas pelo usuário via botão + disciplina ou clicando no calendário são chamadas de disciplinas do usuário e podem ser editadas ou removidas.
📆 Período do semestre
O indicador de semestre fica na barra da agenda semanal e exibe a semana atual dentro do semestre (ex: semana 4/19) e o percentual de progresso.
Clique no ícone ⚙ ao lado do indicador para configurar:
- Nome do semestre: ex. "2026.1 — 1º Semestre".
- Data de início e data de término.
↑↓ Indicador de tendência
Os cartões de disciplina (na agenda e na seção de frequência) exibem um indicador de seta baseado nas últimas aulas:
| Ícone | Significado | Quando aparece |
|---|---|---|
| ↑ | Tendência positiva | Faltou na penúltima aula mas foi à última (recuperando) |
| ↓ | Tendência negativa | Faltou à última aula |
| ↓↓ | Atenção — múltiplas faltas | Faltou às duas últimas aulas consecutivas |
| — | Normal / sem histórico | Frequência em dia ou sem aulas passadas |
O indicador é apenas informativo e não afeta o cálculo de frequência.
📝 Anotações
A seção de anotações oferece duas listas separadas:
- ⏱ Tarefas: itens com prazo ou ação necessária.
- 📚 Tópicos: conteúdos a estudar ou revisar.
Ambas as listas suportam adição via campo de texto (ou Enter), marcação de conclusão via checkbox, edição inline com duplo clique no texto, e remoção com desfazer por 5 segundos.
📦 Arquivados
Disciplinas arquivadas ficam visíveis na seção arquivados da página principal com o percentual de frequência final. Ao clicar em um card arquivado é possível:
- Ver o histórico completo de presença.
- Desarquivar (↩): restaura a disciplina como ativa.
- Remover permanentemente (✕): exclui todos os dados da disciplina.
📤 Exportar / Importar
Os dados podem ser exportados e importados via botões no cabeçalho ou no rodapé da página. O formato é Excel (.xlsx) com as seguintes abas:
| Aba | Conteúdo |
|---|---|
| Presença | Registro de presença por aulaId (sim/não) |
| Eventos | Eventos personalizados do calendário |
| Tarefas | Lista de tarefas com status |
| Tópicos | Lista de tópicos com status |
| Info | Versão e data de exportação |
📍 Presença automática
Se o usuário conceder permissão de localização, o app verifica periodicamente (a cada 2 minutos) se o dispositivo está dentro de um raio de 1 km do campus. Se uma aula estiver em andamento (ou com até 5 minutos de antecedência), a presença é marcada automaticamente.
- As coordenadas do campus são configuradas internamente (Campus do Pici – UFC, Fortaleza).
- A verificação ocorre também ao retornar à aba do navegador.
- Para economizar bateria, a localização só é solicitada quando há aula no momento.
📡 Modo offline
O app funciona sem conexão com a internet:
- Dados são carregados do localStorage quando offline.
- Alterações de presença são enfileiradas no IndexedDB e sincronizadas automaticamente ao reconectar.
- A sincronização usa backoff exponencial (2s, 4s, 8s… máx. 60s) com até 5 tentativas por operação.
- Um badge ● offline aparece no cabeçalho quando sem conexão.
- Um badge ⏳ N pendentes indica operações aguardando sincronização.
📱 PWA — Instalar como app
O flow.planner é um Progressive Web App. Para instalar como aplicativo nativo:
- Chrome / Edge (desktop): clique no ícone de instalação na barra de endereços → Instalar.
- Safari (iOS): toque em Compartilhar → Adicionar à Tela de Início.
- Chrome (Android): toque no menu → Adicionar à tela inicial.
O app funciona offline após instalado graças ao Service Worker.
⌨ Atalhos de teclado
| Tecla | Ação |
|---|---|
| ← | Semana anterior |
| → | Próxima semana |
| T ou Home | Voltar para a semana atual |
| Esc | Fechar popup ou modal aberto |
| Enter | Adicionar tarefa/tópico no campo de texto ativo |
Atalhos funcionam apenas quando o foco não está em um campo de texto.
❓ Perguntas frequentes
Não. O app funciona sem login usando apenas o armazenamento local do navegador (localStorage / IndexedDB). Criar uma conta é opcional e permite sincronizar seus dados entre dispositivos via Supabase.
Sim. Todos os dados são persistidos automaticamente no localStorage do seu navegador. Se você estiver logado, os dados também são sincronizados na nuvem. A única situação em que os dados locais são perdidos é se você limpar manualmente o cache e os dados do site.
O cálculo segue a Lei 9.394/96 (LDB), art. 24, VI, que exige frequência mínima de 75% do total de horas letivas. Portanto:
- Limite de faltas (h) = ⌊ Carga Horária Total × 0,25 ⌋
- Exemplo: disciplina de 60h → limite de 15h de falta.
O cálculo é feito em horas, não em número de aulas, respeitando a carga horária real de cada disciplina.
Sim. O flow.planner é um PWA (Progressive Web App) com suporte completo a modo offline. Após a primeira visita, os arquivos são armazenados em cache pelo Service Worker. Alterações feitas offline são enfileiradas e sincronizadas automaticamente quando a conexão for restaurada.
Quando a data de término do semestre é ultrapassada, todas as disciplinas ativas são arquivadas automaticamente com um snapshot do percentual de frequência final. Você pode revisar o histórico na seção Arquivados e desarquivar qualquer disciplina a qualquer momento.
Sim, desde que você esteja logado com a mesma conta. Os dados são sincronizados em tempo real via Supabase. Sem login, cada dispositivo mantém seu próprio armazenamento local independente, sem sincronização entre eles.
Se você conceder permissão de localização, o app verifica a cada 2 minutos se você está dentro de um raio de 1 km do campus. Quando há uma aula em andamento (ou com até 5 min de antecedência), a presença é marcada automaticamente. A verificação também ocorre ao retornar à aba do navegador.
Use os botões de exportação/importação no cabeçalho ou rodapé da página principal. O arquivo gerado é um Excel (.xlsx) com abas separadas para Presença, Eventos, Tarefas, Tópicos e Info.
Sim. Ao marcar uma aula como cancelada, ela é removida do cálculo de frequência — nem presença nem falta são contabilizadas. A aula aparece riscada no calendário com o label ⊘ cancelada. Você pode desfazer o cancelamento a qualquer momento clicando em "↩ desfazer cancelamento".
É um indicador visual baseado nas últimas aulas da disciplina:
- ↑ — você faltou na penúltima aula mas foi à última (recuperando).
- ↓ — você faltou à última aula.
- ↓↓ — faltou às duas últimas aulas consecutivas.
- — — frequência em dia ou sem histórico suficiente.
O indicador é apenas informativo e não altera o cálculo de frequência.
Apenas eventos personalizados (criados por você, não aulas de disciplinas) podem ser arrastados. Clique e segure sobre o evento e arraste-o até a nova posição na grade. O posicionamento faz snap em intervalos de 15 minutos.
Use a função de exportação para gerar um arquivo Excel com seus dados de presença, eventos e listas. Guarde esse arquivo em um local seguro. Para restaurar, basta importar o mesmo arquivo em qualquer dispositivo com a mesma conta ou no mesmo navegador.