Glossário do Sistema (Dicionário de Domínio)¶

Versão: 1.0 Escopo: Documento central projetado para garantir a Linguagem Ubíqua em todos os artefatos e cerimônias do projeto. Qualquer termo de negócio, jargão ou regra de sistema que possa gerar ambiguidade deve ser catalogado aqui.

ABCDEILOPRSTUV

Access Token¶

Definição: Token de curta duração (ex.: 15 minutos), no formato JWT, assinado e stateless, usado para autenticar a maioria das requisições de um usuário já logado. Não é persistido em banco de dados; torna-se inútil naturalmente após expirar.
Sinônimos Evitados: “Token de sessão” (termo genérico demais — especificar Access Token ou Refresh Token), “Chave de API”
Módulos Associados: Sessão, Login

Adiamento (Snooze)¶

Definição: Ação que posterga temporariamente o reaparecimento de um item ativo, com opções pré-definidas (“Amanhã” às 08:00, “Em 3 dias”, “Próxima semana”) ou uma data específica escolhida manualmente pelo usuário.
Sinônimos Evitados: “Adiar prazo” (não altera a due date, apenas o reaparecimento), “Pausar item”, “Ocultar item”
Módulos Associados: Todo List, Planner Diário

Arquivado¶

Definição: Estado do item posterior à conclusão, alcançado exclusivamente por ação manual do usuário. Nesta versão do sistema não existe arquivamento automático.
Sinônimos Evitados: “Arquivamento automático”, “Histórico do sistema”
Módulos Associados: Todo List, Cadernos

Bloco de Tempo¶

Definição: Representação visual, dentro do calendário, de um item TODO que possui simultaneamente horário definido e data limite.
Sinônimos Evitados: “Evento”, “Compromisso” (termos reservados a itens SCHEDULE)
Módulos Associados: Calendário

Bloqueio Temporário (Proteção contra Força Bruta)¶

Definição: Estado de restrição automática aplicado a uma conta após 5 tentativas de login malsucedidas consecutivas, impedindo novas tentativas de autenticação por um período pré-definido (ex.: 15 minutos). O contador de tentativas falhas é zerado após um login bem-sucedido.
Sinônimos Evitados: “Conta banida”, “Suspensão permanente” (o bloqueio é temporário e automático — diferente de Desativação de Conta, que é uma ação voluntária do usuário)
Módulos Associados: Login, Segurança de Conta

Busca¶

Definição: Funcionalidade de localização de Itens por correspondência textual restrita ao título, aplicável exclusivamente a itens do tipo TODO. Cadernos e itens do tipo SCHEDULE nunca são retornados. Pode ser refinada por filtros de status, caderno, prioridade e período.
Sinônimos Evitados: Pesquisa avançada, Filtro geral
Módulos Associados: Busca

Definição: Processo de criação de uma nova conta de Usuário, exigindo no mínimo nome, e-mail e senha. O e-mail é validado quanto ao formato e à unicidade; a senha é armazenada apenas como hash (nunca em texto puro), seguindo a política mínima de 8 caracteres com pelo menos uma letra e um número. Ao ser concluído com sucesso, a conta é criada diretamente com status Ativa.
Sinônimos Evitados: “Registro” (padronizar como “Cadastro”), “Onboarding”
Módulos Associados: Cadastro, Segurança de Conta

Caderno¶

Definição: Unidade raiz e obrigatória da hierarquia de organização do sistema, pertencente a exatamente um Usuário. Todo conteúdo (Itens) deve, eventualmente, pertencer a um Caderno. Não representa uma tarefa ou compromisso em si, mas o contêiner estrutural de mais alto nível.
Sinônimos Evitados: “Pasta”, “Projeto”, “Categoria”, “Lista” (reservado para “Todo List”)
Módulos Associados: Cadernos, Inbox, Todo List, Calendário

Ciclo de Vida do Item¶

Definição: Sequência de estados pelos quais todo item transita: Inbox (não classificado) → Ativo (classificado, aguardando execução) → Concluído (marcado como feito) → Arquivado (movido manualmente após conclusão); Deletado pode ocorrer a partir de qualquer um desses estados. O estado de Adiamento (Snooze) é uma condição temporária sobreposta ao estado Ativo.
Sinônimos Evitados: “Status” (isolado, sem especificar qual estado), “Fase do item”, “Estado da Conta” (terminologia reservada aos estados do Usuário — ver Estados da Conta; “Ativo/Ativa” tem significados distintos para Item e para Conta)
Módulos Associados: Todos os módulos

Configurações / Preferências¶

Definição: Módulo do Sistema de Autenticação (seção 1.10) responsável por centralizar a visualização e a alteração dos dados de cadastro do usuário, além de dar acesso à funcionalidade de Alteração de Senha. Nesta versão, seu foco é exclusivamente o gerenciamento da conta — não há preferências específicas do Sistema de Tarefas.
Sinônimos Evitados: “Opções da conta”, “Ajustes gerais”, “Preferências de tarefas” (fora do escopo deste módulo na V1)
Módulos Associados: Configurações (Sistema de Autenticação)

Data Limite (Due Date)¶

Definição: Atributo opcional de um item TODO que define seu prazo de vencimento, de forma independente da existência de um horário definido. A presença de data limite (isolada ou combinada com horário) determina se — e como — o item aparece no calendário.
Sinônimos Evitados: “Prazo final”, “Deadline”, “Data de vencimento” (padronizar como “Data Limite/Due Date”)
Módulos Associados: Todo List, Calendário, Busca

Desativação de Conta¶

Definição: Ação disponível no módulo de Configurações que permite ao usuário autenticado desativar a própria conta. Ao ser desativada, todas as sessões ativas são encerradas imediatamente e o status da conta muda para Desativada; os dados são preservados, mas o acesso normal fica impedido até a Reativação de Conta.
Sinônimos Evitados: “Exclusão de Conta” (ações distintas — a desativação preserva os dados e é reversível; a exclusão remove os dados permanentemente)
Módulos Associados: Configurações, Segurança de Conta

Duplicação de Item¶

Definição: Ação que cria uma cópia de um item preservando título (com prefixo opcional “Cópia de”), caderno de origem e prioridade — sempre no estado Ativo e sem datas definidas. Não são copiados: o status de conclusão, os sub-itens vinculados, nem o vínculo com um SCHEDULE associado.
Sinônimos Evitados: “Clonagem completa”, “Cópia idêntica”
Módulos Associados: Todo List, Cadernos

Estados da Conta¶

Definição: Conjunto dos quatro status possíveis de uma conta de Usuário: Ativa (uso normal), Bloqueada Temporariamente (bloqueio automático por força bruta), Desativada (desativada pelo próprio usuário, dados preservados) e Excluída (remoção solicitada pelo usuário, com exclusão em cascata).
Sinônimos Evitados: “Status do usuário” isolado (especificar qual dos quatro estados), “Estado do Item” (terminologia reservada ao Ciclo de Vida do Item)
Módulos Associados: Segurança de Conta, Configurações

Exclusão de Conta¶

Definição: Ação solicitada pelo usuário que remove permanentemente sua conta. Diferentemente da deleção isolada de um Caderno (que preserva os itens, movendo-os para a Inbox), a exclusão de conta remove em cascata todos os Cadernos e Itens do usuário, já que não há para onde movê-los.
Sinônimos Evitados: “Desativação de Conta” (reversível, não remove dados), “Deletar Caderno” (comportamento distinto — preserva itens na Inbox)
Módulos Associados: Configurações, Segurança de Conta

Inbox¶

Definição: Área de captura rápida — não classificada como um Caderno — que permite o registro de itens sem necessidade de organização imediata. Um item deixa a Inbox automaticamente no momento em que é associado a um Caderno.
Sinônimos Evitados: “Caderno padrão”, “Caderno Inbox”, “Caixa de entrada permanente”
Módulos Associados: Inbox, Cadernos

Item¶

Definição: Entidade central e unificada do sistema, podendo assumir o tipo SCHEDULE (“o que acontece”) ou TODO (“o que fazer”). Todo Item pertence a exatamente um Caderno — e, por consequência, transitivamente a um único Usuário — ou reside temporariamente na Inbox antes da classificação.
Sinônimos Evitados: “Tarefa” (usar apenas ao referir-se especificamente ao tipo TODO), “Evento” (usar apenas para o tipo SCHEDULE)
Módulos Associados: Todos os módulos

Definição: Processo de autenticação do usuário pelo par e-mail + senha, comparando o hash da senha informada com o hash armazenado — a senha original nunca é comparada diretamente. Em caso de sucesso, gera uma Sessão; em caso de falha, retorna mensagem genérica de “credenciais inválidas”, sem indicar qual campo está incorreto, para evitar enumeração de contas cadastradas.
Sinônimos Evitados: “Login social”, “Autenticação via terceiros” (não suportados nesta versão)
Módulos Associados: Login, Sessão

Ordenação¶

Definição: Critério de ordenação aplicado automaticamente às listagens quando nenhuma ordenação específica é acionada pelo usuário, seguindo a sequência: Prioridade > Data Limite > Data de Criação.
Sinônimos Evitados: “Ordenação manual” (é uma opção distinta, baseada em drag & drop), “Ordenação aleatória”
Módulos Associados: Todo List

Planner Diário¶

Definição: Visão que exibe os itens do tipo TODO referentes a um dia específico — incluindo os que não possuem qualquer data associada. Itens do tipo SCHEDULE nunca aparecem nesta visão, sendo exclusivos do calendário.
Sinônimos Evitados: “Agenda do dia” (reservado para a Visão Agenda do Calendário), “Calendário diário”
Módulos Associados: Planner Diário

Prioridade¶

Definição: Escala numérica de 4 níveis (1 = Crítica a 4 = Baixa) atribuída a um item, admitindo também a ausência de prioridade (nulo). É utilizada como primeiro critério na ordenação padrão do sistema.
Sinônimos Evitados: “Urgência”, “Importância”, “Nível” (isolado, sem indicar a escala P1–P4)
Módulos Associados: Todo List, Busca

Reativação de Conta¶

Definição: Fluxo acionado quando um usuário tenta fazer login com e-mail + senha válidos em uma conta com status Desativada. Como as credenciais estão corretas, o sistema não trata a tentativa como falha de autenticação — em vez disso, informa a desativação e solicita confirmação explícita para reverter o status para Ativa e prosseguir com o login. Não depende de e-mail ou qualquer canal externo.
Sinônimos Evitados: “Recuperação de senha” (fluxo inexistente nesta versão; a reativação não envolve troca de credenciais)
Módulos Associados: Login, Segurança de Conta

Recorrência¶

Definição: Mecanismo que permite a um item (TODO ou SCHEDULE) repetir-se automaticamente segundo um padrão básico (diário, semanal ou mensal), podendo possuir uma data de término. Nesta versão do sistema, não há suporte a exceções, cancelamento ou sobrescrita (override) de instâncias individuais da série.
Sinônimos Evitados: “Repetição customizada”, “Série editável por instância”, “Recorrência com exceções”
Módulos Associados: Todo List, Calendário

Refresh Token¶

Definição: Token opaco de longa duração (ex.: 30 dias), usado exclusivamente para renovar o Access Token. É persistido no banco de dados (apenas seu hash) em uma tabela de sessões, associado ao usuário e, opcionalmente, ao dispositivo/user agent. Pode ser revogado individualmente ou em massa.
Sinônimos Evitados: “Token de sessão” (usar termo específico), “Access Token” (durações e propósitos distintos)
Módulos Associados: Sessão, Segurança de Conta

Revogação de Sessão¶

Definição: Ação de invalidar um ou mais Refresh Tokens ativos de um usuário. Pode ocorrer de forma individual (ex.: logout de um dispositivo específico) ou em massa (ex.: troca de senha ou desativação de conta), que invalidam todas as sessões ativas — exceto, no caso de troca de senha, a sessão corrente.
Sinônimos Evitados: “Logout” (usar apenas para a revogação individual da sessão corrente)
Módulos Associados: Sessão, Segurança de Conta, Configurações

SCHEDULE¶

Definição: Item que representa algo com horário fixo e obrigatório (data/hora de início e término), como uma aula ou consulta. Pode ser recorrente. É exibido exclusivamente no calendário, nunca no planner diário ou nas listas de tarefas.
Sinônimos Evitados: “Tarefa com horário”, “Compromisso” (quando usado sem distinção do tipo TODO)
Módulos Associados: Calendário

Segurança de Conta¶

Definição: Módulo do Sistema de Autenticação responsável por gerenciar o Bloqueio Temporário por força bruta, a Desativação de Conta e a Reativação de Conta.
Sinônimos Evitados: “Configurações de Conta” (módulo distinto, focado em dados de cadastro e senha)
Módulos Associados: Segurança de Conta

Sessão (Gerenciamento de Sessão)¶

Definição: Mecanismo que mantém o usuário autenticado entre requisições, baseado em um modelo híbrido de dois tokens (Access Token e Refresh Token), transportados via cookie httpOnly, Secure e SameSite. Suporta múltiplas sessões simultâneas por usuário (uma por dispositivo/login), cada uma identificável e revogável individualmente.
Sinônimos Evitados: “Login persistente” (termo vago), “Token” isolado (especificar Access Token ou Refresh Token)
Módulos Associados: Sessão, Login, Configurações

Sub-item¶

Definição: Unidade vinculada exclusivamente a um Item do tipo TODO, representando uma parte/etapa dele. Opera sob hierarquia estritamente 1:N (Pai-Filho simples): pertence a um único TODO e não pode ser reaproveitado em outro item — se o mesmo passo for necessário em outro lugar, deve ser recriado de forma independente.
Sinônimos Evitados: “Checklist compartilhado”, “Subtarefa reutilizável”, “Etapa global”
Módulos Associados: Todo List, Cadernos

TODO¶

Definição: Item que representa algo a ser feito. Possui horário opcional, pode ter data limite (due date) independentemente do horário, admite sub-itens, possui estado de conclusão (is_completed) e pode ser associado a, no máximo, um item SCHEDULE.
Sinônimos Evitados: “Tarefa” isolada sem contexto, “Lembrete”, “Ação pendente”
Módulos Associados: Todo List, Planner Diário, Calendário, Busca

Usuário¶

Definição: Entidade raiz de todo o modelo de dados do sistema. Todo Caderno pertence a exatamente um Usuário e, por consequência, todo Item e Sub-item pertence transitivamente a um único Usuário. Não há acesso anônimo aos dados: toda operação sobre Cadernos, Itens e Sub-itens exige uma Sessão autenticada válida.
Sinônimos Evitados: “Conta” isolado (usar “Usuário” para a entidade e “Conta”/“Estados da Conta” ao referir-se especificamente às suas credenciais e status)
Módulos Associados: Cadastro, Login, Sessão, Segurança de Conta, Cadernos

Visão Agenda¶

Definição: Um dos quatro modos de visualização do Calendário (junto com Diária, Semanal e Mensal). Consiste em uma lista puramente cronológica exibindo os próximos eventos e tarefas com data, diferindo das demais visões por não usar formato de grade ou timeline.
Sinônimos Evitados: Lista de eventos
Módulos Associados: Calendário

Visão Diária¶

Definição: Um dos modos de visualização do calendário, caracterizado por uma timeline vertical representando as 24 horas de um dia específico.
Sinônimos Evitados: Agenda do dia, Calendário diário.
Módulos Associados: Calendário.

Visão Mensal¶

Definição: Modo de visualização do calendário que apresenta uma grade tradicional exibindo os dias do mês.
Sinônimos Evitados: Visão geral do mês.
Módulos Associados: Calendário.

Visão Semanal¶

Definição: Um dos modos de visualização do planejamento temporal, exibindo sete colunas dispostas em timeline vertical abrangendo a semana.
Sinônimos Evitados: Grade semanal, Agenda da semana.
Módulos Associados: Calendário.