nstech

Suporte Cabotagem · Chamados Maersk

Plantão

Última subida em produção

A semana em números

Onde estão os chamados

Fluxos de Trabalho do Suporte MultiTMS (nstech)

Base para criação de artefato. Documento descreve apenas fluxos de trabalho (quem faz, em que ordem, com qual ferramenta e o que sai de cada etapa). Versão 1.0 · 18/10/2026 · Autor: Rafael

0. Convenções

Atores (raias)

RaiaPapel no fluxo
ClienteAbre o chamado e valida o atendimento
SuporteTriagem, análise, registro de problema, retorno ao cliente, documentação
DEVValida a categoria quando há dúvida técnica, analisa e corrige bugs
POTransforma melhorias em História de Usuário

Ferramentas (ícones do desenho)

ÍconeFerramentaUso no fluxo
Laranja/vermelho (macro)GLPIAbertura do chamado e macros de status ("Em atendimento", "Em Análise Técnica", "Atendido"), campos Análise de Causa e Justificativa de Causa
Asterisco laranjaClaude (skills)/analisar-chamado-multitms, /criar-bug, /criar-us, documentação, mensagem ao cliente
AzulAzure DevOpsCards "Problema em prod" e "História de Usuário", atribuição de dev

Tipos de nó

TipoDescrição
inicio / fimEventos de início e fim
tarefaAtividade executada por um ator
subprocessoAtividade que tem fluxo próprio detalhado neste documento (caixa com barras laterais no desenho)
decisaoLosango com saídas rotuladas

Status do chamado no GLPI (macros)

Aberto → Em atendimento → (Em Análise Técnica, quando vira bug) → Atendido

1. Fluxo principal: Atendimento de chamado (F01)

Objetivo: levar um chamado da abertura ao encerramento, roteando por categoria (Dúvida, Bug, Melhoria).
Gatilho: cliente abre chamado no GLPI.
Saídas: chamado "Atendido" no GLPI, card no DevOps (quando bug ou melhoria), regra registrada na documentação.

1.1 Etapas

PODEVSuporteClienteDúvidaBug / MelhoriaNãoSimMelhoriaBugDúvidaNãoSimSimNão: volta para a correçãoAbrir chamadoGLPIMacro "Ematendimento"GLPIRodar/analisar-chamadoClaudeAnalisar chamado(F02)Categoria dochamado?Existe a regranadocumentação?Validar com Dev/POCategoria dochamado?Criar US da melhoria(F05)ClaudeCard História deUsuárioDevOpsCriar problema emprod (F04)ClaudeCard Problema emprodDevOpsMacro "Em AnáliseTécnica"GLPIEncaminhar devresponsávelDevOpsAnalisar o cardDevOpsSubir correçãoPreencher evidênciasDevOpsA correçãoresolveu?Preencher causa ejustificativaGLPIInserir regra nadocumentação (F07)ClaudeRetornar pro cliente(F03)ClaudeValidar atendimentoGLPICard atendido?Macro "Atendido"GLPIFim
GLPIClaude (skills)Azure DevOpsDecisãoSubprocesso (fluxo próprio no guia)
Ver a tabela de etapas
IDRaiaEtapaTipoFerramentaPróximo
F01-00ClienteInício● início—F01-01
F01-01ClienteAbrir chamadotarefaGLPIF01-02
F01-02SuporteMacro "Em atendimento"tarefaGLPIF01-03
F01-03SuporteRodar /analisar-chamado-multitmstarefaClaudeF01-04
F01-04SuporteAnalisar chamadosubprocesso (F02)—D1
D1SuporteComo você avalia a categoria do chamado?◆ decisão—Bug/Melhoria → F01-05
Dúvida → D2
D2SuporteExiste a regra na documentação?◆ decisãoDocumentação MultiTMSSim → F01-20
Não → F01-05
F01-05SuporteValidar com Dev/POtarefa—D3
D3DEVComo você avalia a categoria do chamado?◆ decisão—Melhoria → F01-06
Bug → F01-08
Dúvida → F01-19
F01-06POCriar US da melhoriasubprocesso (F05)ClaudeF01-07
F01-07POCriar card História de Usuário no DevOpssubprocessoAzure DevOpsF01-20
F01-08SuporteCriar problema em prodsubprocesso (F04)ClaudeF01-09
F01-09SuporteCriar card Problema em prod no DevOpssubprocessoAzure DevOpsF01-10
F01-10SuporteMacro "Em Análise Técnica"tarefaGLPIF01-11
F01-11DEVEncaminhar um dev responsáveltarefaAzure DevOpsF01-12
F01-12DEVAnalisar o cardtarefaAzure DevOpsF01-13
F01-13DEVSubir correçãotarefa—D4
D4SuporteA correção resolveu o problema?◆ decisão—Sim → F01-15
Não → F01-14
F01-14SuportePreencher evidênciastarefaAzure DevOpsF01-12 (loop)
F01-15SuportePreencher causa e justificativatarefaGLPI (Fluxo Cabotagem)F01-19
F01-19SuporteInserir regra na documentaçãosubprocesso (F07)ClaudeF01-20
F01-20SuporteRetornar pro clientesubprocesso (F03)ClaudeF01-21
F01-21ClienteValidar atendimentotarefaGLPID5
D5ClienteCard atendido?◆ decisão—Sim → F01-22
Não → D4
F01-22SuporteMacro "Atendido"tarefaGLPIF01-99
F01-99—Fim● fim——

1.2 Caminhos resumidos

Dúvida com regra documentada
Abrir→Em atendimento→Análise→Dúvida→regra existe→Retornar pro cliente→Validar→Atendido
Dúvida sem regra documentada
regra não existe→Validar com Dev/PO→DEV confirma Dúvida→Inserir regra na documentação→Retornar pro cliente→Validar→Atendido
Bug
Validar com Dev/PO→DEV confirma Bug→Criar problema em prod→Card no DevOps→Em Análise Técnica→Dev responsável→Analisar→Subir correção→Resolveu? (loop com evidências até resolver)→Causa e justificativa→Inserir regra na documentação→Retornar pro cliente→Validar→Atendido
Melhoria
Validar com Dev/PO→DEV confirma Melhoria→PO cria US→Card História de Usuário→Retornar pro cliente→Validar→Atendido
• Reprovação do cliente: "Card atendido? Não" devolve para a decisão "A correção resolveu o problema?", reabrindo o ciclo de evidências e correção.

1.3 Diagrama (Mermaid)

1.4 Pontos a confirmar no desenho

1. No caminho Melhoria, o desenho não passa por "Preencher causa e justificativa" nem por "Inserir regra na documentação". Confirmar se é intencional (a regra só entra na documentação quando a melhoria for entregue).
2. Em "Card atendido? Não", a seta volta para "A correção resolveu o problema?". Para chamados de Dúvida ou Melhoria isso não se aplica; confirmar o destino da reprovação nesses casos (provavelmente volta para "Analisar chamado").
3. Escalonamento Cloudworks: nem todo chamado "Com dev" vai para o Azure DevOps, alguns vão para a Cloudworks (ver F06). O desenho ainda não tem essa saída.

2. Subfluxo: Análise e diagnóstico do chamado (F02)

Expande: F01-04 "Analisar chamado".
Objetivo: chegar à causa-raiz e à categoria correta antes de qualquer encaminhamento.
Gatilho: chamado em "Em atendimento" e skill /analisar-chamado-multitms executada.
Saídas: categoria (Dúvida, Bug, Melhoria), Análise de Causa (lista fechada do plugin Fluxo Cabotagem), Justificativa de Causa em texto puro, casos semelhantes no histórico.
IDEtapaDetalhe
F02-01Coletar o mínimoNº do chamado, cliente, instância, ambiente (prod, homolog, QA), documento envolvido (chave, protocolo, ID), XML da carga/documento, print ou mensagem de erro literal
D1Tem o mínimo para investigar?Não → F03 (modelo "Retorno parcial / pedido de informação" ou "Abertura pedindo XML") e aguarda cliente · Sim → F02-02
F02-02Localizar o momento no ciclo da cargaCriação da carga → vínculo de NF-e → cálculo de frete → emissão de CT-e → MDF-e → integração pós-viagem
F02-03Aplicar checklist por documentoCT-e, MDF-e, NF-e, NFS-e, EDI PROCEDA, CIOT (checklist-diagnostico-multitms)
F02-04Consultar a documentação MultiTMSPDFs locais (Navegação e Rodoviário) e documentação de Carga, Fatura, Tipo de Operação
F02-05Cruzar com o histórico do GLPIExport CSV diário: casos semelhantes, causas já usadas pelo time
F02-06Formular hipótese → onde verificar → como confirmarEm EDI, apontar registro e posição; não inventar conteúdo de campo
F02-07Entender o incidente como ocorreuO estado atual da tela não invalida o diagnóstico de um problema passado
D2Qual a natureza da causa-raiz?Parametrização/cadastro · Uso/regra de negócio · Integração do lado do cliente · Infraestrutura externa (SEFAZ, prefeitura, InvoiCy/Migrate) · Defeito do produto · Oportunidade de melhoria
F02-08Mapear para a categoria do F01Parametrização, uso, integração do cliente e infra externa → Dúvida · Defeito do produto → Bug · Comportamento correto mas insuficiente → Melhoria
F02-09Preencher campos do GLPIAnálise de Causa (lista fechada) e Justificativa de Causa (texto corrido, sem HTML, sem rótulos)
Regra de classificação: falha externa (ex.: webservice municipal fora) é classificada como Dúvida, não como "Falha na aplicação".

3. Subfluxo: Comunicação com o cliente (F03)

Expande: F01-20 "Retornar pro cliente" e os pedidos de informação do F02.
Objetivo: responder com linguagem acessível e tecnicamente correta.
Saídas: mensagem publicada no GLPI.
IDEtapaDetalhe
D1Qual o momento da comunicação?Abertura (falta XML) · Retorno parcial (falta informação) · Orientação de parametrização · Andamento de bug · Melhoria registrada · Encerramento
F03-01Selecionar modeloBiblioteca modelos-comunicacao-ptbr
F03-02RedigirTom externo profissional e acessível; usar nomes reais de campos (ex.: AcordoFaturamento); não tratar gap de configuração como bug; propor evolução em vez de "correção" quando for melhoria
F03-03RevisarSem dados sensíveis desnecessários; causa resumida em 1 a 2 frases
F03-04Publicar no GLPISegue para "Validar atendimento" (F01-21)
Tom interno (dev, chat): direto e informal (modelo "Mensagem rápida de chat").

4. Subfluxo: Registro de bug "Problema em prod" (F04)

Expande: F01-08 e F01-09.
Ferramenta: skill /criar-bug + Azure DevOps.
Saída: texto pronto para colar no work item "Problema em prod" (não gera documento).
IDEtapaDetalhe
F04-01Partir da análise do F02Causa-raiz e evidências já levantadas
F04-02Entrevista etapa 1: dados básicos e planejamentoURL, Versão, Data de atualização · Previsão de término, Prioridade, Responsável
F04-03Entrevista etapa 2: comportamentoComportamento observado com evidência real de produção, esperado vs. observado, passos para reproduzir
F04-04Gerar texto dos camposDados básicos, Description, Planejamento
F04-05Criar card no DevOpsColar nos campos do work item "Problema em prod"
F04-06Macro "Em Análise Técnica" no GLPIVolta ao F01-10

5. Subfluxo: Criação de História de Usuário (F05)

Expande: F01-06 e F01-07.
Ferramenta: skill /criar-us + Azure DevOps.
Saída: US em Word (.docx) no papel timbrado da nstech e card "História de Usuário".
IDEtapaDetalhe
F05-01Partir da análise do chamado (F02)Entrada pode ser print, texto colado ou só o número do chamado
F05-02Entrevista etapa 1: cabeçalhoCódigo da US informado pelo Rafael (padrão NFTP-1116; usar XXXXXX se ainda não existe), Ambiente de Aplicação (URL), Responsáveis
F05-03Entrevista etapa 2: entendimento do problema—
F05-04Entrevista etapa 3: regra de negócio e limitesSem detalhe técnico, o dev decide a implementação
F05-05Rascunho no chatMarcadores no lugar dos prints
D1Rascunho aprovado?Não → ajustar e voltar a F05-05 · Sim → F05-06
F05-06Gerar .docx timbradoCaixa emoldurada com título sombreado, depois Ambiente e Responsáveis
F05-07Criar card História de Usuário no DevOpsVolta ao F01-20
Regra de trilha: defeito de produção nunca vira US, vai para F04.

6. Subfluxo: Escalonamento técnico (F06)

Objetivo: decidir para onde vai um chamado que sai do suporte para o técnico.
Status: rascunho, critério de escolha a confirmar.
IDEtapaDetalhe
D1Para quem escalar?Produto MultiTMS → Azure DevOps (F04/F05) · Infraestrutura/ambiente → Cloudworks
F06-01Registrar destino no GLPIStatus "Com dev"
F06-02AcompanharVer F08

7. Subfluxo: Inserir regra na documentação (F07)

Expande: F01-19 "Inserir regra na documentação".
Objetivo: cada chamado resolvido que revelou regra não documentada vira conteúdo na Documentação MultiTMS.
IDEtapaFerramentaDetalhe
D1A seção da regra já existe?—Não → F07-01 · Sim → F07-02
F07-01Documentar a etapa/documentar-etapa-multitmsTemplate de 8 seções, com jornada do usuário e dicionário de campos críticos
F07-02Revisar o bloco existente/revisar-doc-multitmsReescreve no template de 8 seções (migra blocos antigos de 6 seções)
F07-03Publicar na documentação—Documentação do cliente e, quando for regra interna, POP/FAQ do time

8. Fluxo: Gestão e acompanhamento da fila (F08)

Objetivo: visão diária da fila Cabotagem e dos cards em desenvolvimento.
Gatilho: rotina diária.
IDEtapaFerramentaDetalhe
F08-01Exportar CSV do GLPIGLPIMesmo modelo todo dia, fila Cabotagem, com campos do plugin Fluxo Cabotagem
F08-02Atualizar painelPainel "Chamados Cabotagem"Gestão de chamados passa a ser 100% pelo painel (Google Agenda descontinuado)
F08-03Reconciliar fontesGLPI, painel, DevOpsApontar divergências acionáveis (status, duplicidades, causa não preenchida)
F08-04Monitorar "Problema em prod"Azure DevOpsCards ainda ativos parados em sprint antiga
F08-05Cobrar / reencaminhar—Dev responsável ou Cloudworks

9. Fluxo: Melhoria contínua da documentação por chamados (F09)

Objetivo: usar as causas dos chamados para achar lacunas na documentação.
Gatilho: periódico, a partir de um export CSV em lote.
IDEtapaFerramentaDetalhe
F09-01Ler export CSV do GLPI/gaps-doc-por-chamados-multitmsAnálise de Causa e Justificativa de Causa
F09-02Agrupar por tema recorrente——
F09-03Listar gaps provados pelos chamados—Entrega no chat, sem arquivo
F09-04Auditar a documentação/auditar-doc-multitmsLacunas contra o padrão de 8 seções, backlog único priorizado (.md)
F09-05Executar backlogF07Documentação do cliente e POP/FAQ interno

10. Fluxo: Registro de reuniões em ATAs (F10)

Objetivo: guardar decisões de reuniões (maioria no Microsoft Teams) e usar o acervo na revisão da documentação.
Status: processo em construção.
IDEtapaDetalhe
F10-01Realizar reuniãoMicrosoft Teams
F10-02Registrar ATALivro de Atas
F10-03Extrair regras e decisõesItens que afetam regra de negócio do MultiTMS
F10-04Alimentar revisão da documentaçãoEntrada para F07 e F09

11. Fluxo: Documentação de processo interno (F11)

Objetivo: transformar processos internos do time (infra, suporte, operação) em POP.
Ferramenta: /documentar-processo-nstech.
IDEtapaDetalhe
F11-01Entrevista guiadaClaude pergunta, Rafael responde
F11-02Montar POP em Markdown—
F11-03Revisar e publicarBase de POP/FAQ interno

12. Mapa de relacionamento entre fluxos

FluxoChamaÉ chamado por
F01 Atendimento de chamadoF02, F03, F04, F05, F06, F07—
F02 Análise e diagnósticoF03 (pedido de informação)F01
F03 Comunicação com o cliente—F01, F02
F04 Registro de bug—F01
F05 Criação de US—F01
F06 Escalonamento técnicoF04, F05, F08F01
F07 Inserir regra na documentação—F01, F09, F10
F08 Gestão da filaF06rotina diária
F09 Melhoria contínua da documentaçãoF07periódico
F10 ATAs de reuniãoF07, F09reuniões
F11 Processo interno (POP)—sob demanda

Aguardando retorno por responsável (nstech)

Divisão da fila · nstech × Maersk

Texto do informe diário

Gerado a partir do export do GLPI. Chamados nstech usam o técnico atribuído; pendentes usam o requerente Maersk. Marca (+30 dias) para os que passam de 30 dias em aberto.

Fila por idade

Fila por status

Carga por técnico (aberto × resolvido)

Chamados em aberto () · ordenados por idade

Escala de plantão ()

Dias úteis: das 18:00 do dia até as 08:00 do dia seguinte. Sábado e domingo: quem assume às 08:00 fica até as 08:00 do dia seguinte. A linha em destaque é o plantão em andamento agora. A coluna Chamados conta os chamados abertos dentro da janela do plantão, pela data de abertura no GLPI; plantão futuro aparece como traço.

Tickets em aberto por dia · fonte · período

Entradas e saídas por dia

Tickets com mais de 30 dias

Chamados por instância · agrupado · visão

Registro diário

Fluxo semanal · barras = resolvidos por · linha branca = abertos · linha roxa = backlog no fim da semana

SLA por técnico (resolvidos)

Distribuição do tempo de solução

Chamados por nível

Módulos mais afetados

Análise de causa (campo do GLPI)

Preenchimento da causa por técnico (resolvidos)

Análise de causa por instância · recorte · considera a data de solução

Aliança Navegação ·
Maersk Truck ·

Chamados e causas ()

Respeita os filtros da página. O CSV sai separado por ponto e vírgula, pronto para abrir no Excel.

Resolvidos recentes sem causa registrada ()

resolvidos nos últimos
Chamados já fechados em que o campo "Análise de Causa" do plug-in Fluxo Cabotagem ficou em branco. Respeita os filtros da página.

Ações estruturais o que foi feito e se funcionou

filtra todos os gráficos desta aba

Evolução de uma tela ·

Carga travada em alguma etapa ·

NFS-e / prefeitura

CIOT, frete e pedágio

Cards do time de desenvolvimento ()

Mensagem para o time de dev · os cards da seleção acima que ainda não foram concluídos

Atualizações em produção () · ● Aliança   ● Maersk LNS

Clique na linha para ver os itens que foram naquela release. Registro das subidas de versão em produção. As datas aparecem como marco vertical no Histórico diário e no Fluxo semanal, com uma linha por ambiente (laranja = Aliança, azul = Maersk LNS), para comparar o antes e o depois de cada entrega. Só a estreia de cada versão vira marco: subir de novo a mesma versão é hotfix e fica marcado na tabela, sem poluir os gráficos. Itens da release vem da planilha de releases (ligação pela versão: 8.13.0.4 lê a release 8.13), por isso hotfix da mesma versão mostra a mesma lista. Itens do board conta os work items do Azure fechados na janela daquele deploy. Fonte: painel de atualizações da nstech e planilha Itens por release Instância 1 e 3.

Chamados () · clique na linha para ver o detalhe

IDTítuloStatusInstância NívelMóduloCausaTemaPrioridade TécnicoAberturaFinalização HorasSLAPrioridade equipeObservação