Manual de Uso — TOTVS Status Report

📋

Visão Geral do Sistema

O que é e para que serve o Status Report

O Status Report Dashboard é a ferramenta centralizada de acompanhamento da carteira de projetos do GPP da TOTVS Brasil. Ele integra os dados financeiros e contratuais extraídos diariamente do PSA com as informações operacionais registradas pelos Coordenadores de Projeto (CPs).

ℹ️

Os dados do PSA são a fonte oficial de verdade para valores financeiros, clientes e status contratuais. As informações operacionais (RAG, pipeline, atividades, riscos) são responsabilidade do CP.

Dois tipos de informação

Tipo	Origem	Quem atualiza	Frequência
Dados contratuais e financeiros	PSA / Excel	Admin (via sincronização)	Diária ou sob demanda
Dados operacionais do projeto	CP / Atualizar	Coordenador de Projeto	Semanal / quando necessário

👥

Perfis de Usuário

Quatro níveis de acesso com permissões distintas

Admin

Acesso total. Gerencia usuários, dispara sincronização com o Excel e visualiza todos os 643 contratos.

GPP

Visualiza toda a carteira (sem filtro por CP), mas não pode editar projetos nem criar usuários.

CP

Visualiza e atualiza apenas seus próprios projetos (ou projetos/CPs que o admin conceder acesso).

Viewer

Somente leitura, apenas para projetos e CPs que o admin conceder explicitamente.

Admin

Visualizar todos os contratos da carteira GPP (643 contratos)
Disparar a sincronização com o arquivo Excel do PSA
Criar, editar e desativar usuários de qualquer perfil
Conceder acesso de CPs e projetos individuais a outros usuários
Redefinir senha de qualquer usuário
Atualizar informações operacionais de qualquer projeto
Acessar a página de Gestão de Usuários (⚙ Usuários)

GPP (Somente Leitura)

Visualizar todos os contratos da carteira GPP (visão completa, sem restrição por CP)
Acessar o detalhe (one-pager) de qualquer projeto
Usar todos os filtros e KPIs do dashboard

Não pode atualizar informações de nenhum projeto
Não pode acessar a página de Gestão de Usuários
Não pode disparar sincronização Excel

CP (Coordenador de Projeto)

Visualizar seus próprios contratos (onde é coordenador)
Visualizar contratos de CPs adicionais que o admin conceder
Visualizar projetos individuais que o admin conceder
Atualizar informações operacionais dos seus projetos: RAG, pipeline, atividades, marcos, riscos, observação, go-live, paralisação
Acessar o detalhe (one-pager) dos seus projetos

Não pode ver contratos de outros CPs sem concessão explícita do admin
Não pode gerenciar usuários
Não pode disparar sincronização Excel

Viewer (Somente Leitura)

Visualizar somente os projetos que o admin conceder acesso individualmente ou por CP
Acessar o detalhe (one-pager) dos projetos autorizados

Não pode atualizar nenhum projeto
Não pode acessar a página de Gestão de Usuários
Não pode disparar sincronização Excel

📊

Campos vindos do PSA (Excel)

Estes campos são atualizados automaticamente pela sincronização — não podem ser editados manualmente

⚠️

Estes campos refletem o estado do PSA no momento da última sincronização. Qualquer divergência deve ser corrigida na fonte (PSA) — a próxima sincronização trará o valor correto.

Campo no sistema	Coluna no Excel (PSA)	Descrição
Razão do Status	Razão do Status	Estado contratual: Em Execução, Em Replanejamento, Em Planejamento, Rascunho, Bloqueado, Em Aprovação
Cliente	Cliente	Nome da empresa cliente
Código do Cliente	Código (Cliente) (Conta)	Código da conta no PSA
Nome do Projeto	Nome	Nome do contrato/projeto no PSA
Código do Projeto	Código do Projeto	Identificador único (ex: D000074085001)
Data de Emissão	Data de Emissão do Projeto	Data de criação do contrato
Coordenador	Coordenador de Projeto	Nome do CP responsável
GPP	Principal GPP	Gestor de Portfólio de Projetos
Unidade	Unidade Organizacional	Unidade TOTVS responsável
Modalidade	Modalidade de Projeto	Implantação ou Banco de Horas (quando preenchida no PSA)
Custo Planejado	Custo de Despesas Planejadas	Custo total planejado em R$
% Margem do Projeto	% Margem do Projeto	Margem calculada sobre o custo planejado
Valor Total	Valor Total do Projeto	Valor contratual total em R$
Custo Aprovado	Custo Aprovado	Custo aprovado em R$
% Margem Vendida	% Margem vendida	Margem na proposta comercial
Farol	Farol % Margem do Contrato	Dentro ou Fora da Margem do Contrato
Custo Realizado	Custo de Despesas Realizadas	Custo efetivamente incorrido até a data

✏️

Campos editáveis pelo CP

Estas informações são inseridas/atualizadas pelo Coordenador de Projeto na página "Atualizar Projeto"

✅

A sincronização com o Excel nunca sobrescreve estes campos. Eles são preservados independentemente de quantas vezes o Excel for importado.

Campo	Tipo	Descrição
Modalidade CP	Seleção	Classificação operacional: Implantação ou Banco de Horas. Usada quando o PSA não tem a modalidade preenchida.
RAG — Cronograma	Botão (🟢/🟡/🔴)	Status do cronograma do projeto: Ok, Atenção ou Crise.
RAG — Escopo	Botão (🟢/🟡/🔴)	Status do escopo do projeto.
RAG — Recursos	Botão (🟢/🟡/🔴)	Status de alocação de recursos.
RAG — Riscos	Botão (🟢/🟡/🔴)	Status dos riscos mapeados.
Go-Live Previsto	Data (DD/MM/AAAA)	Data esperada de entrada em produção do cliente.
Observação do Período	Texto livre	Comentário situacional sobre o projeto na semana/período.
Pipeline (Fases)	Botão de ciclo	Status de cada fase de implantação: ⬜ A fazer → 🔄 Em andamento → ✅ Concluído → ⏰ Atrasado. Disponível apenas para projetos de Implantação.
Progresso por etapa	Slider (%)	Percentual de conclusão de cada etapa (0–100%). Disponível apenas para projetos de Implantação.
Atividades	Lista gerenciável	Atividades do projeto com responsável, datas e status. É possível adicionar novas, marcar como concluídas ou remover.
Marcos	Lista gerenciável	Entregas-chave do projeto. Podem ser marcadas como concluídas.
Riscos	Lista gerenciável	Riscos mapeados com nível de severidade: 🔴 Alto, 🟡 Médio, 🟢 Baixo.
Paralisação	Toggle + Texto livre	Indica que o projeto está temporariamente paralisado. Exige preenchimento do motivo. Gera indicador visual 🛑 no dashboard e no one-pager.

📁

Dashboard — Visão da Carteira

Página principal com os KPIs, filtros e lista de todos os contratos

👁️

O dashboard exibe apenas os contratos que o usuário tem permissão de visualizar (conforme o perfil). Admin e GPP veem todos; CP vê os próprios + concedidos; Viewer vê apenas os concedidos.

KPI Cards — Clique para filtrar

Card	O que representa	Filtro ativado ao clicar	Perfil
📁 Total Contratos	Total de contratos visíveis	Limpa todos os filtros	Todos
🚀 Implantações	Contratos com modalidade Implantação	Modalidade = Implantação	Todos
⏱ Banco de Horas	Contratos com modalidade BH	Modalidade = Banco de Horas	Todos
⚠️ Sem Modalidade	Contratos sem modalidade definida no PSA	Modalidade = Sem Modalidade	Todos
📉 Fora da Margem	Contratos com farol negativo	Farol = Fora da Margem	Todos
🔴 Em Crise RAG	Contratos com pelo menos um RAG vermelho	RAG = Crise	Todos

Filtros disponíveis

Coordenador — filtra por CP específico (Admin/GPP veem todos; CP vê apenas os seus)
Modalidade — Implantação, Banco de Horas ou Sem Modalidade
Razão do Status — Em Execução, Em Replanejamento, Em Planejamento, Rascunho, Bloqueado, Em Aprovação
Farol — Dentro ou Fora da Margem do Contrato
RAG Status — Crise (🔴), Atenção (🟡), Ok (🟢) ou Sem RAG
Busca livre — pesquisa por nome do cliente, nome do contrato ou código do projeto

Colunas da tabela

Coluna	Origem	Descrição
Código	PSA	Código único do projeto no PSA
Cliente	PSA	Nome do cliente (+ badge 🛑 se paralisado)
Nome do Contrato	PSA	Nome do projeto
Modalidade	Misto	Modalidade do PSA ou definida pelo CP
Razão Status	PSA	Status contratual atual
Valor Total	PSA	Valor total do contrato em R$
% Margem	PSA	Margem do projeto (verde >15%, amarelo 5–15%, vermelho <5%)
Farol	PSA	Indicador de margem: Dentro/Fora do contrato
RAG	CP	4 indicadores: Cronograma, Escopo, Recursos, Riscos
Pipeline	CP	Barra de progresso das fases (só Implantação)
Go-Live	CP	Data prevista de entrada em produção
Atualizado	CP	Responsável e tempo desde a última atualização

Botões da barra superior

Botão	Disponível para	Ação
⟳ Sincronizar Excel	Admin	Importa o arquivo .xlsx mais recente e exibe relatório de alterações
⚙ Usuários	Admin	Acessa a página de gestão de usuários
📋 Atualizar	Admin CP	Acessa a página de atualização de projetos

📄

Detalhes do Projeto (One-Pager)

Visão consolidada de um único projeto — acesse clicando em qualquer linha do dashboard

A página de detalhe exibe todas as informações do projeto em uma única tela. É somente leitura — para editar, use o botão ✏ Atualizar no canto superior direito (disponível para Admin e CP).

Seções exibidas

Banner de Paralisação — aparece em vermelho no topo quando o projeto está paralisado, exibindo o motivo registrado pelo CP
Hero — nome do cliente, nome do contrato, badges de modalidade/status/farol, coordenador e unidade
KPIs financeiros — Valor Total, % Margem do Projeto, % Margem Vendida e Go-Live Previsto
RAG Status (🚦) — painel com os 4 indicadores: Cronograma, Escopo, Recursos e Riscos
Pipeline de Implantação (📋) — fases com status visual (apenas projetos de Implantação)
Progresso por Etapa (📊) — barras de progresso percentual por etapa
Atividades (⚡) — lista de atividades com responsável, datas e status
Marcos (🏁) — entregas-chave com indicador de conclusão
Riscos (⚠️) — riscos mapeados com nível de severidade
Observações (📝) — última observação registrada pelo CP
Rodapé — quem atualizou e quando

✏️

Atualizar Projeto

Disponível para: Admin CP

⚠️

Perfis GPP e Viewer não têm acesso a esta página. Tentar acessar /atualizar.html redireciona automaticamente para o dashboard.

Como usar

1

Selecione o CP

Escolha o Coordenador de Projeto no primeiro dropdown. CPs veem apenas seu próprio nome (e os concedidos pelo admin). Admin vê todos.

2

Selecione o contrato

Busque por código ou nome do contrato. Os contratos listados são apenas os daquele CP.

3

Preencha os campos e salve

Atualize RAG, pipeline, atividades, marcos, riscos, go-live e observação. Clique em "Salvar Atualização" para gravar.

Modalidade CP

Quando o PSA não informa a modalidade (campo Sem Modalidade), o CP deve definir se o projeto é Implantação ou Banco de Horas. Isso habilita ou oculta os campos de pipeline e progresso.

RAG Status

Para cada dimensão (Cronograma, Escopo, Recursos, Riscos) selecione um dos três estados:

🟢 Ok — situação normal, sem desvios relevantes
🟡 Atenção — risco ou desvio identificado, requer monitoramento
🔴 Crise — problema crítico que impacta o projeto, requer ação imediata

Pipeline de Fases (somente Implantação)

As 6 fases padrão (Kick-off, Levantamento, Parametrização, Testes, Treinamento, Go-Live) ciclam entre quatro estados ao clicar:

⬜ A fazer — fase ainda não iniciada
🔄 Em andamento — fase em execução
✅ Concluído — fase finalizada
⏰ Atrasado — fase em atraso

Paralisação do Projeto

Clique no painel 🛑 Paralisação do Projeto e depois no botão ⏸ Paralizar para ativar. Um campo de texto aparece para registrar o motivo. Projetos paralisados recebem indicador visual no dashboard e no one-pager. Para reativar, clique em ▶ Reativar.

⚙️

Gestão de Usuários

Disponível para: Admin — acesse via ⚙ Usuários no dashboard

Criar novo usuário

Clique em + Novo Usuário e preencha:

Nome de exibição — nome que aparece nos registros e no badge do cabeçalho
Username — login único (sem espaços)
E-mail — e-mail TOTVS do usuário (necessário para recuperação de senha)
Perfil (role) — admin, gpp, cp ou viewer
CP Vinculado — obrigatório para perfis cp e viewer; define quais contratos o usuário vê por padrão
Senha — senha inicial (padrão: Totvs@2026). O usuário será obrigado a criar uma nova senha no primeiro login.

ℹ️

Os 24 CPs da carteira já são criados automaticamente na primeira sincronização com o Excel. O campo CP Vinculado de cada um é preenchido automaticamente com o nome do coordenador.

Aba Perfil

Edite nome, username, e-mail, perfil e status (ativo/inativo) de qualquer usuário. O botão Redefinir Senha gera uma nova senha temporária e a envia por e-mail para o usuário — ele será obrigado a criar uma senha pessoal no próximo login.

Aba Acesso por CP

Marque quais CPs adicionais o usuário (cp ou viewer) pode visualizar. O CP base do usuário é marcado automaticamente e não pode ser removido.

Aba Acesso por Projeto

Conceda acesso a contratos individuais. Use a busca para encontrar o contrato pelo cliente, nome ou CP, e clique em + para adicionar. Para remover, clique no × ao lado do contrato. Salve ao final.

⚠️

As abas de acesso são ocultadas automaticamente para usuários com perfil admin e gpp, pois eles já têm visibilidade total da carteira.

⟳

Sincronização com Excel do PSA

Disponível para: Admin

📂

A sincronização é feita via upload direto pelo dashboard. Não é necessário ter acesso ao servidor — basta ter o arquivo .xlsx exportado do PSA no seu computador.

Passo a passo

1

Exporte a planilha do PSA

Exporte todos os projetos do PSA em formato .xlsx com as colunas padrão da extração.

2

Clique em ⟳ Sincronizar Excel no dashboard

O botão fica na barra superior e é visível apenas para o perfil Admin.

3

Selecione o arquivo e envie

Clique em Escolher arquivo, selecione o .xlsx salvo no seu computador e clique em Enviar arquivo. Aguarde a confirmação de upload.

4

Clique em Sincronizar

Após o upload, clique em Sincronizar. O servidor processa o arquivo e exibe o relatório de alterações.

5

Revise o relatório de alterações

O modal exibe: novos contratos adicionados, contratos atualizados (com quais campos mudaram e os valores antigo/novo), contratos sem mudança e contratos que existem no banco mas não constam no Excel.

O que o sync faz e o que ele preserva

Situação	Ação do sistema
Contrato novo (presente no Excel, ausente no banco)	✚ Inserido no banco com os campos do PSA. Para Implantações, as 6 fases e 5 barras de progresso são criadas automaticamente.
Contrato atualizado (campo do PSA mudou)	✎ Apenas os campos do PSA são atualizados. Dados operacionais (RAG, pipeline, atividades, etc.) são preservados.
Contrato sem mudança	✓ Nenhuma ação. Contabilizado no relatório como "sem mudança".
Contrato no banco mas fora do Excel	⚠ Listado no relatório como "fora do Excel". Nenhum dado é removido automaticamente.
CP novo detectado no Excel	Usuário criado automaticamente com username gerado e senha padrão `Totvs@2026`.

🔑

Primeiro Acesso e Senhas

Como fazer login, criar senha pessoal e recuperar acesso

Endereço do sistema

O sistema está disponível na internet pelo endereço fornecido pelo admin (formato https://status-report-totvs.onrender.com). Salve nos favoritos do navegador para acesso rápido.

💡

No plano atual do servidor, ele pode hibernar após 15 minutos sem acesso. O primeiro acesso após hibernação leva cerca de 30 segundos para carregar — aguarde normalmente.

Login

1

Acesse a tela de login

Informe seu username e a senha temporária fornecida pelo admin (padrão: Totvs@2026).

2

Crie sua senha pessoal

No primeiro login, o sistema redireciona automaticamente para a tela Criar Nova Senha. Defina sua senha seguindo os requisitos abaixo.

3

Acesse o dashboard

Após salvar a nova senha, você é redirecionado automaticamente para o dashboard.

Requisitos de senha

Toda senha deve atender obrigatoriamente aos 4 critérios abaixo. A tela de criação de senha exibe em tempo real quais critérios já foram atendidos:

Mínimo de 8 caracteres
Ao menos 1 letra maiúscula (A–Z)
Ao menos 1 número (0–9)
Ao menos 1 caractere especial (!@#$%&* etc.)

Esqueci minha senha

1

Clique em "Esqueci minha senha"

Na tela de login, clique no link abaixo do botão Entrar.

2

Informe seu username

Digite seu username e clique em Enviar Nova Senha.

3

Verifique o e-mail

Uma senha temporária é enviada para o e-mail cadastrado na sua conta. Use-a para logar e o sistema pedirá para criar uma nova senha.

⚠️

O recurso de recuperação por e-mail requer que o admin tenha cadastrado seu e-mail na conta e configurado o servidor de e-mail. Caso não receba, entre em contato com o admin para redefinição manual.

Username padrão dos CPs

Para os 24 CPs, os usernames são gerados automaticamente a partir do nome do coordenador cadastrado no PSA:

Nome simples: bianca, israel, caroline
Nomes duplicados: acrescenta inicial do sobrenome — ex: fernanda e fernanda.n

Em caso de dúvida sobre o username, peça ao admin.

Sessão

A sessão expira automaticamente após 8 horas. Ao expirar, você será redirecionado para a tela de login. Para encerrar antes, clique em Sair no canto superior direito.