Zenith
Ir para o App

Documentação

Guia completo da plataforma Zenith.

Introdução

O Zenith é uma plataforma de gestão ágil de projetos multi-tenant, construída sobre Next.js App Router, Supabase e Tailwind CSS.

Ela unifica Backlog, Sprint Board, Workflows e Relatórios em um único workspace por empresa — sem a fragmentação de ferramentas separadas.

Multi-tenant

Cada empresa tem RLS próprio

Agile-first

Scrum, Kanban e Service Desk

Extensível

Campos e workflows customizáveis

Primeiros Passos

Para começar a usar o Zenith, siga os passos abaixo.

  1. 1

    Crie sua conta

    Acesse /login e cadastre-se com e-mail e senha. Um perfil é criado automaticamente com a role solicitante.

  2. 2

    Crie um Projeto

    No painel, clique em "Novo Projeto" e escolha um template: Scrum, Kanban ou Service Desk.

  3. 3

    Adicione Issues

    Na view de Backlog, crie Épicos, Histórias e Tarefas. Subtarefas herdam os campos do pai automaticamente.

  4. 4

    Inicie um Sprint

    Arraste issues do backlog para a Sprint e clique em "Start Sprint" para ativar o Sprint Board.

Hierarquia de Issues

O Zenith usa uma hierarquia de 4 níveis inspirada no Jira:

Epic

Agrupa Histórias relacionadas. Representa um objetivo ou funcionalidade grande.

História

Unidade de valor entregável ao usuário. Deve caber em um sprint.

Tarefa

Unidade técnica de trabalho. Pertence a uma História ou existe independentemente.

Subtarefa

Detalhe técnico de uma Tarefa. Herda campos do pai automaticamente via trigger.

Ao criar uma Subtarefa, o trigger trg_inherit_parent_fields copia automaticamente os campos priority_id, epic_id, sprint_id e platform_id do pai. Todos os campos herdados podem ser sobrescritos depois.

Sprints & Backlog

O fluxo de sprint no Zenith segue o framework Scrum:

planningSprint criada mas ainda não iniciada. Issues podem ser adicionadas/removidas.
activeSprint em execução. Apenas uma sprint pode estar ativa por vez.
completedSprint encerrada. Issues não finalizadas voltam ao Backlog automaticamente.

Workflows

Cada projeto pode ter um workflow customizado com seus próprios status. Os status são agrupados em três categorias:

A FazerBacklog, A Fazer, Aberto
Em ProgressoEm Andamento, Em Revisão, Aguardando
ConcluídoFinalizado, Fechado, Resolvido

O Burndown Chart e as métricas de velocidade são calculados com base nas transições para a categoria done.

Campos Personalizados

Administradores podem criar campos personalizados por empresa ou por projeto. Tipos suportados:

textnumberdateselectmulti_selectuserurlcheckbox

Campos do tipo select e multi_select suportam opções coloridas via JSONB. Use o painel de configurações do projeto para gerenciá-los.

Relatórios

A página /relatorios oferece os seguintes painéis:

  • ▸ Burndown Chart por Sprint — baseado em ticket_status_history
  • ▸ Velocidade por Sprint — story points entregues por iteração
  • ▸ Distribuição por Tipo de Issue — Epic, Story, Task, Bug
  • ▸ Tempo médio por status (Lead Time e Cycle Time)
  • ▸ Volume de issues abertas vs. fechadas por período