NT Project · Manual
PTENES
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.
  • 📈 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 → Cadastros → Estrutura → Kanban (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). Não vê o painel de Pendências, "Meus Usuários", a contagem de usuários online, o manual nem o tour.
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. Com tasks associadas, as datas do macro seguem as tasks (menor início / maior término) e os campos de data ficam travados.
⚠️ Riscos / 📌 DefiniçõesEscopo, premissas, pontos de atenção, "no radar" e riscos do projeto. Cada risco tem Nome (obrigatório, exibido em todas as telas); risco aberto de probabilidade média ou alta deixa o projeto no mínimo em Atenção.
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).

  • Cada geração traz o 📄 Status detalhado e o 🎯 Resumo objetivo (pontos a observar). Os dois podem ser editados e salvos; há histórico por data (chips) e também status manual.
  • O mais recente (geração ou edição) é o que aparece no Dashboard: no widget de status, o seletor st 1 mostra o resumo automático (regra) e o st 2 o Resumo objetivo. Ao salvar no Setup, o widget passa para o st 2 já atualizado; a escolha fica salva no navegador.
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, Prioridade (Alta/Média/Normal — ordena as raias), Progresso (%), Ponto focal (⭐ líder entre os responsáveis).
  • Data Limite (opcional) — tolerância além da data fim. Entre a data fim e a limite o farol vai a atenção; depois da limite, atrasado. Quando difere da data fim aparece destacada (⏳) em cards, Gantt e popups.
  • Flags: 📦 É entrega, 📍 É milestone e ⌛ Pendência (task originada de uma pendência do projeto).
  • 🔗 Associar tasks novo — com "É entrega" ou "É milestone" marcado, o botão ao lado de Progresso abre a árvore da estrutura do projeto (hierarquia, wave, sprint, pacote ou frente — a que o projeto usa). O % da entrega/milestone passa a ser calculado pelas tasks associadas (média ponderada pela duração) e o campo fica travado; recalcula sozinho quando uma associada é salva. Não é possível criar ciclos.
  • Janela "Associar tasks" novo — mostra as datas de cada task, busca por nome, filtro Só associadas e destaca as tasks ⚠ sem datas.
  • Status (farol) — cinza (não iniciado), verde (OK), amarelo (atenção), vermelho (atrasado), roxo (crítico).
  • Sub-tasks — cada uma com responsável, 🚩 Prioridade própria (Alta/Média/Normal), % Progresso (0/25/50/75/100 ou qualquer valor de 0 a 100), início e término; alimentam o progresso da task. A lista fica em colunas alinhadas (responsável, datas e %).
  • Anexos — arquivos e link do SharePoint na task.
  • Status verde no Backlog novo — ao mudar o status para verde (no formulário ou na grade) de uma task que ainda está no Backlog, o sistema pergunta se deseja movê-la para In Progress, com as mesmas regras do arrastar (datas obrigatórias e aviso de início futuro).
Progresso × raia
Progresso diferente de 0% move a task do Backlog para In Progress. Se o mesmo projeto estiver aberto em outra aba, aparece um aviso — edite em uma aba só para não sobrescrever alterações.

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.
  • Card novo — prioridade com bandeira na cor (Alta vermelha · Média amarela); o rodapé fica numa linha só: ⧉ duplicar, contador de sub-tasks e os botões ver/editar/excluir. O % aparece à direita da linha do prazo. O quadro tem uma única barra de rolagem e os títulos das raias ficam fixos.
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).
  • Entregas atrasadas — no popup, clicar numa entrega abre a edição dela.
  • 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.

  • Cada pendência tem responsável (EC/NT), situação, criticidade (C1–C5), bloqueio/atenção, status, impacto e Entregas impactadas — mostradas com o caminho na estrutura do projeto (ex.: Fase 1 › Deploy em produção), no nome atual da entrega e na ordem da estrutura. Entregas excluídas aparecem riscadas.
  • Viram tasks automaticamente: toda pendência aberta tem uma task no Kanban com a flag ⌛ Pendência (sem duplicar). Concluída → task em Done 100%; cancelada/excluída → task arquivada. Sem data de resolução, a task fica sem data fim ("NÃO DEFINIDO" no Gantt).
  • Data Limite novo (opcional) — mesma regra da task (tolerância após a data de resolução). Pendência com a Data Limite vencida aparece como motivo do atraso no Dashboard, no One Page e no Status Geral (IA).
  • O perfil cliente não vê o painel de Pendências.

📄 One Page Status novo

Botão One Page Status no Dashboard: relatório de uma página para o cliente, exportável em PNG/PDF.

  • Cabeçalho com operação, projeto, saúde e o selo STATUS EM (data/hora do status) em destaque.
  • Cronograma — o mesmo Gantt de Projetos (somente leitura, ajustado à largura): Agrupar por Frente/Etapa, Pacote ou Hierarquia; Exibir todas as tasks ou só entregas & milestones; Período completo ou atrasadas & próximas; mostrar/ocultar a tabela. A customização fica salva para a próxima abertura.
  • Pendências do projeto (abertas, por criticidade, com as entregas impactadas), Riscos de origem Cliente e O que já fizemos · estamos fazendo · faremos.
  • Seções retráteis novo (O que já fizemos, Pendências, Riscos): clique no título para recolher; seção recolhida fica fora do PNG/PDF. O PPF mostra 5 itens por coluna, com "mostrar mais".
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.

  • Visões por dia, semana, mês ou ano · Agregar por Frente/Etapa, Hierarquia ou Pacote · 📋 Tabela de tasks (Task Name, duração, início, término, responsável com etiqueta NT/CLI). Colunas com 👁 podem ser ocultadas. As escolhas ficam salvas.
  • Clique no nome da task para editá-la; ➕ Nova task cria direto do Gantt. Datas de início/fim ficam fora da barra; a Data Limite aparece com ⏳.
  • Estrutura destacada: cada grupo tem cor própria, faixa lateral e barra-resumo (início → fim das suas tasks, com o % concluído). O % do grupo é a média ponderada pela duração (entregas/milestones com tasks associadas não contam em dobro) — o mesmo cálculo do milestone.
  • Ícones: 📦 entrega · pino 📍 milestone (ao lado da data) · ⌛ pendência, com o rótulo PENDÊNCIA nas duas pontas da barra. Pendência sem data fim mostra NÃO DEFINIDO no Término e a barra em degradê até o fim do período.
  • PNG/PDF exportam o gráfico inteiro (todas as linhas e colunas, sem barras de rolagem).
  • Linha de HOJE novo e % esperado nas barras que ela corta; opção Ritmo (real × esperado); faixa da Data Limite; contador de linhas; a visão Por ano posiciona as barras no dia exato.
  • Grupos retráteis novo — clique no nome de qualquer grupo (Frente/Etapa, Hierarquia, Pacote) para recolher/expandir; vale também no Gantt do One Page.

🕸️ 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.

🧭 Painel

Painel do GP/SM em três abas: Status Geral (ações do dia e, no fim, as 📈 Métricas / KPIs — saúde, SPI, progresso real, cycle time, WIP travado e velocity por sprint), Status Tasks (por pessoa e situação) e Entregas do Projeto (diagnóstico por entrega).

💰 Financeiro

Resumo financeiro do projeto consultado no sistema Axis (pelo Código Axis informado no cadastro do projeto).

📓 Diário · 📁 Docs

Diário de bordo (registros datados) e documentos do projeto.

Controle

9 · Governança e acompanhamento

  • Riscos (com Nome obrigatório) e Definições/No radar — mapeados por projeto e refletidos no Status Resumido; risco aberto de probabilidade média/alta deixa o projeto no mínimo em Atenção.
  • Baselines — fotos do planejamento (auto semanal + manuais) para comparar desvios.
  • 💾 Backup do planejamento novo (Cadastro › Backup planejamento) — salva e restaura o planejamento completo: tasks (com Frente/Etapa, dependências e sub-tasks), waves, sprints, pacotes, epics, stories, entregáveis, riscos, definições, pendências, calendário e as referências dos anexos. Restaurar uma baseline cria antes um backup automático. O botão 🧭 Reaplicar Frentes/Etapas preenche só as Frentes/Etapas vazias a partir de um backup, sem alterar mais nada.
  • 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.
  • Interface — visual sóbrio (tons pastéis) padrão para todos e atualização automática dos dados ao trocar de tela.
  • Auditoria — todas as ações relevantes são registradas.
Portfólio e foco

10 · Executivo · Foco

📈 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.br → Equipe 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

Ícones das tasks (Kanban · Gantt · One Page)

📦 Entrega 📍 Milestone (pino) ⌛ Pendência / aguardando ⏳ Data Limite diferente da data fim NÃO DEFINIDO — pendência sem data fim

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.