Projetos e custos

Os projetos são contêineres em nível de trabalho que agrupam listas de tarefas relacionadas. Uma vez que as listas de tarefas estão vinculadas a um projeto, o Ziptask consolida automaticamente o progresso de pontos de esforço, o status de conclusão e — para os donos de conta — as estimativas de custo em dólares de todas elas.

Observação sobre pontos: Os projetos usam o campo Pontos de esforço estimado em cada item de tarefa — não os Pontos de recompensa. Os pontos de esforço representam o peso de trabalho de uma tarefa e impulsionam as estimativas de custo. Os Pontos de recompensa são a moeda de gamificação usada para o ranking e a loja, e são completamente independentes dos custos do projeto. Ambos os campos são definidos separadamente em cada item de tarefa por um Admin ou Root.

Feature flag: projects_enabled — apenas nível Business. O Root pode alterná-la em Configurações da conta → Projetos e custos.

Permissões

Ação	Usuário	Admin / Team Admin	Root
Ver lista e detalhe de projetos	✗	✓	✓
Criar / editar / excluir projetos	✗	✓	✓
Arquivar / desarquivar um projeto	✗	✓	✓
Atribuir um gerente de projeto	✗	✓	✓
Ser atribuído como gerente de projeto	✗	✓ (apenas escopo de conta)	✓
Atribuir uma lista de tarefas a um projeto	✗	✓	✓
Ver totais de pontos e progresso	✗	✓	✓
Ver custos em dólares e despesas	✗	✗	✓
Adicionar / editar / excluir despesas	✗	✗	✓
Configurar etiquetas de consolidação	✗	✓	✓
Ver o relatório Resumo do projeto	✗	✓	✓
Ver o relatório Custos do projeto	✗	✗	✓

Os Usuários padrão nunca veem a seção Projetos. A visibilidade de custos e despesas é controlada pela permissão de Custos do projeto, que apenas o Root detém por padrão. Uma conta pode concedê-la a um Admin ou a uma função personalizada: read mostra os números de custo e a lista de despesas; manage adicionalmente permite adicionar, editar e excluir despesas. Configurar quais etiquetas consolidam faz parte da edição normal de projetos (Admin/Root), não da permissão de custos.

Como funciona

Criando um projeto

Root e Admin podem tocar em Novo projeto na página Projetos. Campos:

Campo	Obrigatório	Descrição
Título	Sim	Precisa ser único dentro da conta (máx. 150 caracteres).
Descrição	Não	Contexto em texto livre mostrado na página de detalhe.
Gerente de projeto	Não	Um membro que pode tanto editar projetos quanto gerenciar qualquer lista de tarefas da conta — na prática, Admin ou Root. Ele pode editar o projeto e gerenciar qualquer lista sob ele. Recebe uma notificação no app e por push quando atribuído. Selecionar “Sem atribuição” deixa o campo em branco.
$ por ponto	Não	Valor em dólares de um ponto ganho (ex.: `5` = $5 por ponto). Usado para estimativas de custo. Deixe em `0` para pular o acompanhamento de custos.
Data de início	Não	Data e hora de início do projeto — escolhida com um controle combinado de data e hora, com padrão de 9h no fuso horário da conta. Exibida na barra lateral. Precisa ser em ou antes do fim.
Data de fim	Não	Data e hora de fim do projeto — padrão de 17h no fuso horário da conta. Exibida na barra lateral.

Os títulos de projeto precisam ser únicos dentro de uma conta. Tentar salvar um título duplicado mostra um erro informando que aquele nome já está em uso.

Editando um projeto

Qualquer Admin ou Root pode editar o título, a descrição, o gerente de projeto, a taxa ou as datas de um projeto a qualquer momento. Se um novo gerente de projeto é atribuído e é diferente do anterior, ele recebe uma notificação no app e por push. Se o gerente de projeto é removido, a pessoa anteriormente atribuída recebe uma notificação de remoção. Nenhuma das notificações dispara se a pessoa que faz a mudança é a mesma que está sendo atribuída ou removida.

Excluindo um projeto

Excluir um projeto não exclui suas listas de tarefas. Todas as listas de tarefas vinculadas são desvinculadas e permanecem totalmente intactas com todos os seus itens e histórico.

Um diálogo de confirmação mostra o título do projeto antes de a exclusão ser efetivada.

Vinculando listas de tarefas a um projeto

Ao criar ou editar uma lista de tarefas, um seletor de Projeto aparece abaixo do seletor de Equipe — mas apenas quando projects_enabled está ativada e existe pelo menos um projeto ativo na conta.

Uma lista de tarefas pode pertencer a um projeto por vez.
Selecionar um projeto vincula a lista; selecionar “Nenhum projeto” a desvincula.
Desvincular uma lista de tarefas não afeta nenhum item ou ponto daquela lista.
Apenas projetos ativos (não arquivados) aparecem no seletor. Projetos arquivados não podem ser atribuídos a listas novas ou existentes até serem desarquivados.

Página de lista de projetos

A lista de projetos mostra um cartão para cada projeto. Cada cartão exibe:

Título e descrição do projeto
Intervalo de datas (datas de início – fim)
Barra de progresso (pontos ganhos ÷ pontos estimados)
Contagens de pontos: X / Y pts
Número de listas de tarefas vinculadas
Um selo Atrasado se alguma lista vinculada passou da data de vencimento com itens incompletos

Os cartões são ordenados alfabeticamente. O campo de busca filtra por título.

A alternância Minhas / Todas limita a lista aos projetos que o membro gerencia ou a todos os projetos que ele consegue ver. O botão de Filtros (ícone de funil) abre um painel com um controle de Status — Ativos ou Arquivados — e mostra um selo de contagem quando um filtro não padrão é aplicado.

Opções de layout (desktop). Um alternador de visualização na barra de ferramentas permite que cada membro mostre os projetos como Cartões (a grade padrão), Linhas (o mesmo cartão, em largura total) ou uma Tabela densa. A visualização em Tabela adiciona uma alternância de densidade Compacta / Confortável. A escolha é lembrada por pessoa e por dispositivo — duas pessoas compartilhando um navegador mantêm sua própria preferência — e o termo de busca, o escopo e a seleção de Status agora persistem ao abrir um projeto e voltar. No celular, a lista sempre mostra cartões empilhados, independentemente da escolha salva.

Página de detalhe do projeto

Clicar em um projeto abre sua página de detalhe, que tem uma barra lateral e uma área de conteúdo principal.

Barra lateral

Seção	O que mostra
Progresso	Barra de progresso, fração de pontos ganhos/estimados, percentual de conclusão e um detalhamento dos totais de pontos Estimados / Ganhos / Restantes.
Cronograma	Data de início, data de fim e número de listas de tarefas vinculadas (só mostrado quando pelo menos uma data está definida).
Gerente de projeto	O nome do membro atribuído com um ícone de pessoa (só mostrado quando um gerente está atribuído).
Custo	(Permissão de Custos do projeto — Root por padrão) A taxa de $/pt; Custo Estimado / Ganho / Restante; mais Despesas e um Total (estimativa de mão de obra + despesas) em dólares.
Ações	Botões de Editar, Arquivar (ou Desarquivar se o projeto estiver arquivado) e Excluir.

Conteúdo principal

Seção	O que mostra
Aviso de não pontuado	Um banner de aviso listando quantas listas têm itens com um valor de Pontos de esforço estimado de 0. Isso significa que as estimativas de custo e progresso podem estar incompletas para essas listas.
Pontos por etiqueta	Uma tabela agrupando os pontos estimados e ganhos por etiqueta em todas as listas vinculadas. Os usuários Root veem uma coluna de Custo adicional. Quais etiquetas aparecem aqui é configurável por projeto (veja Etiquetas de consolidação abaixo).
Despesas	(Permissão de Custos do projeto) Uma lista do dinheiro gasto no projeto — materiais, equipamentos, subcontratados, etc. — cada uma com uma categoria, valor, data e recibo opcional. O total alimenta a coluna de custo da barra lateral. Veja Despesas abaixo.
Listas de tarefas	Toda lista de tarefas vinculada a este projeto. Cada linha mostra o título da lista, uma miniprogressão, a contagem de itens concluídos/totais, os totais de pontos (se pontuados) e um selo Atrasado quando aplicável. Clicar em uma linha navega até aquela lista de tarefas.

Lógica do selo “Atrasado”

Uma lista de tarefas é marcada como Atrasada quando as três condições são verdadeiras:

A lista tem uma data de vencimento definida.
Essa data e hora de vencimento já passaram (comparadas ao momento atual).
Pelo menos um item da lista ainda não está concluído.

O selo aparece tanto na página de lista de projetos (como uma contagem no cartão do projeto) quanto nas linhas de listas individuais dentro da página de detalhe do projeto.

Acompanhamento de custos (apenas Root)

Se a taxa $ por ponto está definida em um projeto, o dono da conta (Root) vê uma seção de custo na barra lateral de detalhe do projeto e no relatório Custos do projeto:

Valor	Cálculo
Custo Estimado	Pontos de esforço estimado × taxa de $/pt
Custo Ganho	Pontos de esforço em itens concluídos × taxa
Custo Restante	Custo Estimado − Custo Ganho
Despesas	Soma de todas as despesas registradas no projeto
Total	Custo Estimado + Despesas

As três primeiras linhas são a estimativa de mão de obra (a partir dos pontos de esforço). Despesas é o dinheiro real gasto, e Total combina os dois. Os custos atualizam ao vivo à medida que os itens são concluídos, os valores de pontos de esforço mudam ou despesas são adicionadas. Por padrão, apenas o Root vê esses números; a permissão de Custos do projeto pode ser concedida a outros.

Os Pontos de recompensa não afetam os cálculos de custo. O valor de Pontos de recompensa de um item de tarefa pode diferir de seus Pontos de esforço estimado — isso é intencional. Por exemplo, uma tarefa rápida, mas de alto valor, pode ter 50 Pontos de recompensa e apenas 2 Pontos de esforço.

Pontos por etiqueta

A página de detalhe inclui uma tabela de detalhamento que agrupa os pontos estimados e ganhos por etiqueta em todas as listas de tarefas vinculadas. Isso é útil para entender quais categorias de trabalho estão impulsionando o esforço estimado.

As etiquetas são puxadas da biblioteca de etiquetas da conta. Apenas as etiquetas que aparecem em pelo menos uma lista dentro do projeto são mostradas.

Etiquetas de consolidação

Por padrão, toda etiqueta em qualquer lista vinculada aparece no detalhamento, o que pode poluí-lo com etiquetas que não são relevantes (ex.: uma etiqueta “Urgente” aparecendo ao lado de etiquetas de fase) e pode contar em dobro uma lista que carrega duas etiquetas. Para controlar isso, escolha uma lista de consolidação por projeto — apenas as etiquetas escolhidas aparecem no detalhamento:

No formulário de Criar/Editar projeto, use o seletor de Etiquetas de consolidação.
Na página de detalhe do projeto, toque em Configurar no cartão Pontos por etiqueta para alterá-lo ali mesmo.
Deixar a seleção vazia consolida todas as etiquetas (o comportamento original), então os projetos existentes não são afetados.

Configurar as etiquetas de consolidação só altera o que o detalhamento exibe — nunca altera os pontos ou custos totais do projeto, que são sempre somados de cada lista vinculada.

Despesas

Além da estimativa de mão de obra baseada em esforço, você pode registrar despesas reais em um projeto — materiais, equipamentos, subcontratados, e assim por diante — para que a coluna de custo reflita o dinheiro real gasto, não apenas a mão de obra estimada.

A seção Despesas fica entre o cartão Pontos por etiqueta e as listas de tarefas na página de detalhe do projeto. Cada despesa tem:

Campo	Observações
Descrição	Para o que foi a despesa (obrigatório).
Valor	Valor em dólares (obrigatório).
Categoria	Uma categoria com cor. Quatro vêm integradas — Materiais, Equipamentos, Subcontratado, Outros — e você pode adicionar as suas (veja abaixo). (Não há categoria “Mão de obra” — a mão de obra da sua equipe já é medida pelos pontos de esforço; a mão de obra externa que você paga entra em Subcontratado.)
Data	Quando foi incorrida (padrão é hoje).
Recibo	Uma foto ou PDF opcional do recibo, anexado por despesa.

A soma de todas as despesas aparece como a linha Despesas na coluna de custo, e é adicionada à estimativa de mão de obra para dar um Total. As despesas também aparecem no relatório Custos do projeto.

Categorias de despesa personalizadas. As quatro categorias integradas se encaixam em trabalhos no estilo construção, mas nem todo negócio gasta da mesma forma — um bufê acompanha Local, Alimentos e bebidas e Pessoal, em vez disso. Ao registrar ou editar uma despesa, abra o seletor de Categoria e escolha uma categoria existente ou digite um novo nome e escolha uma cor para criar uma na hora. As categorias personalizadas são salvas na sua conta e aparecem no seletor para toda despesa futura, com cor no detalhamento de gasto por categoria. As quatro categorias integradas são padrões compartilhados e não podem ser renomeadas nem removidas. Novas categorias podem ser criadas por qualquer um que possa adicionar despesas (a permissão manage de Custos do projeto).

Quem pode usar: ver despesas requer a permissão de Custos do projeto (read); adicionar ou editar despesas e criar categorias requer o nível manage dessa permissão. Apenas o Root a detém por padrão — conceda-a a um Admin ou a uma função personalizada para dar acesso a outros. Os recibos fazem parte da despesa, então funcionam esteja ou não o recurso geral de Anexos ativado.

Notificações

Evento	Quem é notificado
Atribuído como gerente de projeto	O membro recém-atribuído (no app + push)
Removido como gerente de projeto	O membro anteriormente atribuído (no app + push)

As notificações não são enviadas quando um admin se atribui como gerente de projeto, ou quando se remove. Tocar em uma notificação de gerente de projeto navega diretamente para a página de detalhe do projeto.

Arquivando projetos

Os projetos podem ser arquivados em vez de excluídos. Arquivar remove um projeto da lista de projetos ativos sem perder nenhum dado — todas as listas de tarefas vinculadas, o histórico de pontos e os números de custo são preservados.

Como arquivar: Na página de lista de projetos, toque no menu ⋯ em um cartão de projeto e escolha Arquivar projeto. Na página de detalhe do projeto, use o botão Arquivar nas ações da barra lateral. Ambos mostram uma confirmação antes de efetivar.

Opção em cascata: A confirmação de arquivamento inclui uma alternância opcional: Arquivar também todas as listas ativas (N). Quando ativada, todas as listas de tarefas atualmente ativas vinculadas ao projeto são arquivadas ao mesmo tempo. Isso fica desativado por padrão. As listas que já estavam arquivadas antes de o projeto ser arquivado não são afetadas.

Vendo projetos arquivados: Abra Filtros na barra de ferramentas da página Projetos e escolha Arquivados em Status para mudar para a visualização de arquivados. Os cartões de projeto arquivados exibem uma borda esquerda tracejada, título em itálico e texto esmaecido para distingui-los dos projetos ativos.

Desarquivando: Na visualização de arquivados, toque em ⋯ em um cartão de projeto e escolha Desarquivar projeto, ou use o botão Desarquivar na barra lateral da página de detalhe. Uma confirmação é mostrada. A confirmação de desarquivamento também inclui uma alternância opcional: Desarquivar também todas as listas arquivadas (N). Quando ativada, todas as listas arquivadas vinculadas ao projeto são restauradas para ativas. Isso fica desativado por padrão — as listas também podem ser desarquivadas individualmente na página de listas de tarefas.

Totais de pontos e custos: Arquivar uma lista de tarefas que pertence a um projeto não a remove dos totais do projeto. Todas as listas sempre contribuem para as consolidações de pontos e custos, independentemente do status de arquivamento. Isso garante que os projetos arquivados mantenham números históricos precisos.

Relatórios

Dois tipos de relatório estão disponíveis quando as duas flags reporting_enabled e projects_enabled estão ativadas:

Relatório	Acesso	O que mostra
Resumo do projeto	Root, Admin	Uma linha por projeto: contagem de listas, pontos estimados, pontos ganhos, % concluído, contagem de atrasados.
Custos do projeto	Permissão de Custos do projeto (Root por padrão)	Todos os campos do Resumo do projeto mais: taxa de $/pt, custo estimado, custo ganho, custo restante, despesas e custo total.

Ambos os relatórios aceitam um filtro de intervalo de datas. Um projeto é incluído se seu período ativo (Data de início a Data de fim) se sobrepõe ao intervalo selecionado.

Notas de suporte

A feature flag é por conta. Desativar projects_enabled oculta a seção Projetos e o seletor de projeto nos formulários de lista de tarefas. As associações de projeto existentes são preservadas e restauradas quando a flag é reativada.
Excluir um projeto não exclui as listas de tarefas. Isso limpa o vínculo do projeto nessas listas. As listas e todos os seus itens permanecem intactos.
A unicidade de título é por conta. Duas contas diferentes podem ter projetos com o mesmo nome sem conflito.
O campo de gerente de projeto é funcional, não apenas um rótulo. O gerente de projeto atribuído pode editar, arquivar e excluir o projeto mesmo que não o tenha criado. Apenas membros que podem tanto editar projetos quanto gerenciar qualquer lista de tarefas da conta aparecem no seletor de gerente de projeto — tipicamente Admin ou Root. Uma função personalizada precisa incluir as duas capacidades para se qualificar.
O acompanhamento de custos é opcional. Definir $/pt em 0 pula a estimativa de mão de obra. As despesas são acompanhadas separadamente e ainda contribuem para as linhas de Despesas e Total mesmo quando $/pt é 0.
As despesas precisam da permissão de Custos do projeto. Se alguém não consegue ver ou adicionar despesas, verifique a função dele — ver precisa de Custos do projeto (read), e adicionar/editar precisa do nível manage. Apenas o Root a tem por padrão.
As etiquetas de consolidação são apenas de exibição. Restringir quais etiquetas consolidam nunca altera os pontos ou o custo totais de um projeto — apenas arruma o detalhamento de Pontos por etiqueta. Uma seleção vazia consolida todas as etiquetas.
Pontos de esforço ≠ Pontos de recompensa. Os projetos usam os Pontos de esforço estimado para as consolidações de custo — não os Pontos de recompensa. Ambos os campos são definidos independentemente em cada item de tarefa. Um item pode ter qualquer combinação de valores (ex.: alta recompensa mas baixo esforço, ou vice-versa).
O aviso de não pontuado aparece quando alguma lista vinculada tem itens de tarefa com um valor de Pontos de esforço estimado de 0. Resolva-o definindo os pontos de esforço nesses itens — os Pontos de recompensa não têm efeito nas estimativas de custo do projeto.
Os pontos são ao vivo. Os pontos estimados e ganhos em um projeto atualizam em tempo real conforme os itens são concluídos, adicionados ou removidos. Não há etapa de recálculo manual.
Os relatórios exigem as duas flags. reporting_enabled também precisa estar ativada para que os relatórios Resumo do projeto e Custos do projeto apareçam.
Se um projeto está “faltando” na lista, ele pode ter sido arquivado. Os projetos arquivados só aparecem quando Arquivados está selecionado em Filtros → Status na página Projetos.
Arquivar um projeto não cascateia automaticamente. As listas permanecem em seu estado atual, a menos que o usuário ative explicitamente a alternância de cascata na confirmação de arquivamento. As listas sempre podem ser arquivadas ou desarquivadas de forma independente na página de listas de tarefas.
As listas arquivadas ainda contam nos totais do projeto. As consolidações de pontos e custos sempre incluem todas as listas vinculadas, independentemente do status de arquivamento, então os números históricos em projetos arquivados permanecem precisos.
O seletor de projeto só mostra projetos ativos. Se um Admin relata que um projeto não está aparecendo como opção ao criar ou editar uma lista de tarefas, verifique se aquele projeto foi arquivado.