NT Project · Manual
NT Consult · Engenharia de Software

Manual do NT Project — uma jornada da criação do projeto à gestão das entregas

Este manual segue o uso real da ferramenta, na ordem em que você trabalha: criar a operação e o projeto, montar os cadastros, definir a estrutura, criar tasks no Kanban e acompanhar tudo no Dashboard. É a mesma jornada do tour guiado (botão ❓ Tour no topo do app), detalhada.

Perfis: admin · operações · GP/SM · equipe · viewer · cliente
Visão geral

1 · Comece aqui

O NT Project organiza o trabalho em áreas acessíveis pelas abas do topo do app:

  • ⚙️ Operações — o coração: cada operação (cliente/contrato) contém seus projetos. É onde se planeja e gerencia a entrega.
  • ⭐ Iniciativas STAR — iniciativas internas com cronograma próprio.
  • 📈 Executivo — visão de portfólio (todas as operações/projetos).
  • 🎯 Projetos Foco — recorte dos projetos que você acompanha de perto.
  • 🛠️ Sustentação — demandas de operações continuadas (5W1H, Eisenhower, kanban).
A jornada em 6 passos
Operação → Projeto → CadastrosEstruturaKanban (tasks) → Dashboard. Cada passo abaixo detalha um pedaço dessa jornada.

Perfis de acesso

PerfilO que pode
admin / operações / gp_smAcesso total de gestão (criar/editar operações, projetos, cadastros, tasks).
equipeEdita tasks das quais é responsável (inclusive progresso); move no kanban.
viewerSomente leitura.
clienteVê apenas o Dashboard dos projetos liberados (recorte por projeto).
Passo 1 da jornada

2 · Criar a Operação e o Projeto

  1. Criar a Operação

    Em ⚙️ Operações → + Nova Operação

    A operação representa o cliente/contrato. Informe nome, gerente da operação e responsável técnico. Depois cadastre as equipes.

    ⚠️ Obrigatório
    • Nome da operação (único).
  2. Cadastrar as Equipes

    Abas 👥 Equipe NT e 🤝 Equipe Cliente da operação

    Pessoas cadastradas aqui ficam disponíveis como responsáveis das tasks. Um usuário criado com e-mail @ntconsult.com.br entra automaticamente como Equipe NT; outro domínio, como Equipe Cliente (ver §11).

  3. Criar o Projeto

    Dentro da operação → + Novo Projeto

    Informe nome, datas de início/fim, GP e Scrum Master. As datas do projeto alimentam o "esperado pelo calendário" na Saúde/Dashboard — sem elas, o sistema deriva do intervalo das tasks.

    Dica
    Projetos podem ter sub-projetos (hierarquia de projetos) e ser arquivados (saem das contagens sem perder dados).
Passo 2 da jornada

3 · Cadastros — a base das tasks

Antes de criar tasks, cadastre os itens que ficarão disponíveis nos campos da task. Tudo em Projetos → 📝 Cadastro, em abas:

CadastroPara quê
🌊 WavesGrandes ondas/fases macro do projeto (agrupam sprints).
🎯 Epics → 📖 StoriesÉpicos e histórias (requisito/valor). Story guarda também critérios de aceite e cenários de teste.
🏃 SprintsCiclos de execução. Uma sprint pode vincular uma ou mais Stories (multi-seleção).
📦 Pacotes de trabalhoAgrupadores de esforço por escopo.
🎁 Entregáveis MacrosEntregas macro que as tasks alimentam; têm datas, responsável, progresso e status próprios.
⚠️ Riscos / 📌 DefiniçõesEscopo, premissas, pontos de atenção, "no radar" e riscos do projeto.
Por que primeiro?
Waves, Sprints, Stories, Pacotes e Entregáveis aparecem como opções nos campos da task. Cadastre-os antes para ligar cada task à estrutura certa.
Passo 3 da jornada · destaque

4 · Definir a estrutura do projeto

Você monta a estrutura do jeito que fizer sentido — e as dimensões coexistem: uma mesma task pode ter wave, sprint, pacote, frente/etapa, story e hierarquia ao mesmo tempo. Abaixo, os arranjos possíveis (mesmos diagramas do tour):

🌊 Wave → Sprint → Task

Waves agrupam Sprints; cada Sprint contém as Tasks. Para projetos com grandes ondas, cada uma com vários ciclos.

projetoWave 1Wave 2Wave nSprint 1Sprint 2Sprint nTask 1Task 2Task n

🏃 Sprint → Task

Sprints contêm as Tasks diretamente, sem a camada de waves. Execução ágil enxuta.

projetoSprint 1Sprint 2Sprint nTask 1Task 2Task n

📦 Pacote → Task

Pacotes de trabalho agrupam Tasks por escopo/esforço, sem sprints.

projetoPacote 1Pacote 2Pacote nTask 1Task 2Task n

🎁 Entregável macro → Task

Entregáveis macros agrupam as Tasks que os constroem — bom para acompanhar as entregas macro.

projetoEntregávelmacro 1Entregávelmacro 2Entregávelmacro nTask 1Task 2Task n

📐 Frente → Etapa → Task

Frentes dividem o trabalho; cada Frente tem Etapas; as Tasks ficam nas Etapas. Bom para fluxos por fase (Planejamento → Dev → Testes). Configura-se em Setup → Frentes e Etapas.

projetoFrente 1Frente 2Frente nEtapa 1Etapa 2Etapa nTask 1Task 2Task n

🧭 Hierarquia (multinível) → Task

Hierarquia de equipes/estrutura com quantos níveis precisar; as Tasks ficam no nível folha. Configura-se em Setup → Hierarquia.

projetoHierarq. 1Hierarq. 2Hierarq. nNível 1.aNível 1.bNível 1.cNível 2.aNível 2.bNível 2.cTask 1Task 2Task n
Regra de ouro
Escolha só as dimensões que fizerem sentido para o seu projeto. Não é obrigatório usar todas — mas, quando usadas, filtram o Kanban e organizam o Dashboard.
Configuração do projeto

5 · Setup do projeto

Em Projetos → ⚙️ Setup você define as regras e a estrutura de fluxo:

📊 Frentes e Etapas

Define as frentes e as etapas do fluxo de trabalho, que aparecem nos campos da task e nos filtros do Kanban. Há atalho ⚙️↗ no próprio formulário da task.

🧭 Hierarquia de equipes

Monta a estrutura hierárquica (qualquer nível) usada para classificar as tasks e desenhar a rede no Diagrama.

📅 Calendário / dias úteis

Liga feriados nacionais (BrasilAPI) e/ou "somente dias úteis". Ao cadastrar/editar datas de tasks, entregas e milestones, o sistema avisa se caírem em dia não útil e sugere o próximo dia útil (não é retroativo). Há também o botão 🗓️ Analisar datas em dias não úteis, que revisa tudo e aplica o ajuste em massa.

🚦 Criticidade de atraso de entregas

Define como uma entrega/entregável atrasado afeta a Saúde do projeto:

  • Exigente (padrão) — qualquer entrega atrasada leva direto para ATRASADO.
  • Régua gradual — 1 entrega recém-vencida e isolada → ATENÇÃO; vira ATRASADO quando acumula (≥ quantidade) ou persiste (dias vencidos > carência). Parametrizável.

Essa configuração vale para os widgets, o gauge, o Status Geral e o status gerado pela IA.

🧭 Status Geral (IA) · Baseline · E-mails

Status Geral gera uma narrativa executiva do projeto por LLM (com base nos dados). Baseline tira uma "foto" do planejamento (automática semanal ou manual) para comparação. E-mails de setup configuram envios periódicos de status por lado (NT/Cliente).

Passo 4 da jornada

6 · Kanban e criação de tasks

No Kanban as tasks fluem por raias. Crie tasks com ➕ Criar nova task.

Backlog
A fazer
In Progress
Em execução
Review
Em revisão
Attention
Requer atenção
Blocked
Bloqueada
Done
Concluída

Anatomia de uma task

  • Responsável(eis) — multi-seleção de Equipe NT/Cliente.
  • Datas início/término → duração em dias úteis. Há flag "sem datas definidas".
  • Vínculos — Sprint (mostra a Story), Wave, Pacote, Story, Frente, Etapa, Hierarquia.
  • Tipo, Progresso (%), É entrega / É milestone.
  • Status (farol) — cinza (não iniciado), verde (OK), amarelo (atenção), vermelho (atrasado), roxo (crítico).
  • Sub-tasks — cada uma com início, término e % ; alimentam o progresso da task.

Regra de status ao concluir novo

Ao mover uma task para Done (arrastar, prompt de 100% ou grid):

  • Status verde → conclui direto.
  • Status cinza (Não Iniciado) → bloqueia: é preciso escolher um status ou cancelar. Nenhuma task vai para Done cinza.
  • Status amarelo/vermelho/roxo → pergunta se deseja alterar o status antes de concluir.

Cards e filtros

  • No card, o chip da Sprint abre a(s) Story(ies) vinculada(s) (abas quando há mais de uma); o chip da Story abre seus detalhes.
  • A barra de filtros (tipo/etapa, sprint, wave, pacote, epic, story, responsável) é por projeto — não herda de outro projeto — e só aparece na seção Kanban.
Passo 5 da jornada

7 · Dashboard — acompanhamento

O Dashboard consolida a saúde e o andamento do projeto. Widgets principais:

  • Saúde do Projeto (gauge) e Status Resumido — veredito único (Saudável/Atenção/Atrasado/Crítico) considerando ritmo × calendário e entregas atrasadas.
  • Fluxo Kanban e Status das Tasks / Entregas — contagens por raia e por situação (Em dia, Atrasadas, Vencendo hoje, Bloqueadas, Done, Entregas atrasadas).
  • Linha do Tempo — Tempo × Progresso — tempo decorrido vs progresso real (ponderado por duração), com penalidade por entregas atrasadas. Checkbox ⚖️ Ritmo alterna a regra de sub-task atrasada (só datas × real<esperado).
  • Alocação de Equipes, KPIs e análises complementares.
Coerência
Quando o progresso real está acima do esperado mas há entregas não realizadas, todos os status (inclusive a IA) reforçam: apesar de termos executado mais que o planejado, as entregas pendentes geram atraso.

📌 Pendências

Painel deslizante do projeto. O contador lateral conta apenas as pendências com situação Aberta ou Em andamento.

Além do essencial

8 · Outras visões do projeto

📈 Gantt

Cronograma temporal das tasks; barras por duração em dias úteis, com baseline opcional para comparar planejado × real.

🕸️ Diagrama (Rede)

Rede de relacionamentos/estrutura do projeto (frentes, etapas, hierarquia e dependências).

🗂️ WBS

Estrutura analítica do trabalho (work breakdown) em blocos.

🎯 PPF (Passado/Presente/Futuro)

Board de acompanhamento por horizonte temporal.

📈 Métricas · 🧭 Painel

Indicadores do projeto e painel do GP/SM.

📓 Diário · 📁 Docs · 🤝 Cliente

Diário de bordo (registros datados), documentos do projeto e a visão de Status Cliente (plano de ação).

Controle

9 · Governança e acompanhamento

  • Riscos e Definições/No radar — mapeados por projeto e refletidos no Status Resumido.
  • Baselines — fotos do planejamento (auto semanal + manuais) para comparar desvios.
  • Status Geral (IA) — narrativa executiva e resumo objetivo, respeitando a criticidade de atraso configurada.
  • Notificações (🔔) e controle de concorrência — travas de edição por task e aviso quando outro usuário altera o projeto.
  • Auditoria — todas as ações relevantes são registradas.
Portfólio e foco

10 · STAR · Executivo · Foco

⭐ Iniciativas STAR

Iniciativas internas com cronograma, kanban, Gantt e status próprios.

📈 Executivo

Portfólio consolidado de todas as operações/projetos, com status por frentes.

🎯 Projetos Foco

Seleção dos projetos que você acompanha; agrega status, avanços da semana e foco da próxima.

Operações continuadas

11 · Sustentação 🛠️ módulo

A aba 🛠️ Sustentação (topo do app) é para operações continuadas: rastrear as demandas de manutenção/evolução dos ambientes dos clientes, priorizá-las e acompanhá-las. Acesso restrito ao perfil admin (com liberação por usuário).

Como funciona a jornada

  1. Cadastrar o Cliente de sustentação

    Em 🛠️ Sustentação → + Novo Cliente

    Cada cliente é um workspace próprio, com segmento, SLA, contato e a equipe (profissionais NT e Cliente) que serão os responsáveis das demandas.

  2. Registrar a Demanda (plano 5W1H)

    Dentro do cliente → nova demanda

    Descreva a demanda com o 5W1H: What (o quê), Why (por quê), Where (onde), When (quando), Who (quem) e How (como). Informe datas (início/fim), responsável, urgência e impacto.

  3. Priorizar (Eisenhower + RICE)

    Visão 🎯 Matriz

    A partir de urgência × impacto, a demanda cai num quadrante Eisenhower: Fazer (urgente+importante), Agendar, Delegar ou Eliminar. Um score RICE-lite = (Alcance × Impacto × Confiança) ÷ Esforço ajuda a ordenar o que atacar primeiro.

  4. Executar no Kanban + tasks de avanço

    Visão 📋 Kanban

    As demandas fluem por raias (as mesmas do Kanban de Operações: Backlog → In Progress → … → Done), com arrastar-e-soltar. Cada demanda tem tasks de avanço com progresso; demandas com prazo vencido recebem o selo ⏰ Atrasada.

Duas visões

📋 Kanban

Board de demandas por status, com cards mostrando quadrante, prioridade, progresso das tasks e responsável.

🎯 Matriz (Eisenhower)

Triagem visual por urgência × impacto para decidir Fazer / Agendar / Delegar / Eliminar.

Escopo
Sustentação é independente dos projetos de Operações — foca no fluxo contínuo de demandas por cliente, não em cronograma de entrega. Requer as tabelas sust_* no banco (DDL manual).
Administração

12 · Usuários, perfis e segurança

Em 👤 Usuários (admin). Cada usuário recebe um perfil e as operações/projetos que pode acessar.

  • Auto-cadastro como equipe novo — ao criar/editar um usuário com operações selecionadas, ele é inserido como pessoa da operação: e-mail @ntconsult.com.brEquipe NT; outro domínio → Equipe Cliente. E-mail externo também força o perfil cliente.
  • Escopo — quem não é admin/global só gerencia usuários dentro das suas operações.
  • 1º acesso — troca de senha obrigatória; o tour guiado é oferecido automaticamente (com opção "não mostrar novamente", persistida por conta).
  • Cliente — abre direto o Dashboard dos projetos liberados; sem navegação de gestão.
Consulta rápida

13 · Referência rápida

Farol de status da task

Cinza — Não Iniciado Verde — OK Amarelo — Atenção Vermelho — Atrasado Roxo — Crítico

Campos obrigatórios (resumo)

EntidadeObrigatório
OperaçãoNome (único)
ProjetoNome
TaskDescrição, Responsável, Data início e Data fim (para sair do Backlog)
Sprint / Wave / PacoteNome

Ordem recomendada de trabalho

  1. Criar Operação + Equipes.
  2. Criar Projeto (com datas).
  3. Cadastros: waves, epics/stories, sprints, pacotes, entregáveis.
  4. Definir a estrutura e o Setup (frentes/etapas, hierarquia, calendário, criticidade).
  5. Criar tasks no Kanban e executar.
  6. Acompanhar pelo Dashboard e gerar o Status Geral.
Reveja o tour
Botão ❓ Tour no topo do app abre a jornada guiada a qualquer momento.