> For the complete documentation index, see [llms.txt](https://ajuda.consistem.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.consistem.com.br/tecnologia/erp/componentes/funcionalidades/gantt.md).

# Gantt

O Gantt é uma solução visual interativa para planejamento, sequenciamento e monitoramento temporal de projetos, tarefas e recursos no ecossistema do ERP. Ele combina uma árvore de tarefas expansível (Tree Grid), uma linha do tempo gráfica parametrizável (Timeline Canvas), marcos temporais (Milestones), dependências lógicas e um painel analítico integrado (Dashboard Resumo).

<figure><img src="https://1535499562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFuSXZSnkY0bm1EPoBQFD%2Fuploads%2FIA5F9wrFoFHjkCmTtXup%2F2026-11-03_14h47_07.png?alt=media&amp;token=e51f9ca7-d87f-4944-a4b8-dee211149714" alt=""><figcaption></figcaption></figure>

### **Acesso**

O Gantt não é acessado por meio de uma tela específica. Essa ferramenta visual é incorporada e acessada diretamente por meio de programas desenvolvidos para o Consistem ERP.

O acesso ao componente e às rotinas que o implementam segue as regras de governança e controle de permissões do sistema, ficando visível aos usuários conforme as atribuições de perfil e as rotinas liberadas para cada área.

#### 1. Arquitetura e visão geral

A tela é construída em uma estrutura de abas e painéis articulados:

1. **Barra de Controle Superior**:

* **Navegação por abas:** Alternância entre a visualização temporal (Cronograma da Semana / cronograma geral) e a visão analítica (Resumo).

<div align="left"><figure><img src="https://1535499562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFuSXZSnkY0bm1EPoBQFD%2Fuploads%2Fh2B8DFLpEUi2j2swapRI%2Fabas.png?alt=media&amp;token=5c77f9d9-9587-47c9-b2ef-913ed212b527" alt=""><figcaption></figcaption></figure></div>

* **Seletor de escala/granularidade (visualizações)**: Dropdown que define a resolução da régua temporal. Suporta as visões de: Meia hora, Hora, Dia, Semana, Mês, Trimestre e Ano.
* **Campo de busca e filtro**: Campo de entrada com busca textual rápida para filtrar tarefas na árvore e na linha do tempo.

<div align="left"><figure><img src="https://1535499562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFuSXZSnkY0bm1EPoBQFD%2Fuploads%2F4sBV7AyptNI1z6WgmzeG%2Fbusca.png?alt=media&amp;token=7e075d39-1810-4001-8842-919d3ab3e75f" alt=""><figcaption></figcaption></figure></div>

2. **Painel lateral esquerdo (lista hierárquica de tarefas)**:

* **Exibição em árvore** com suporte a estrutura analítica recursiva (pais e filhos).
* **Controles de recolhimento/expansão** com divisor ajustável (splitter) para redimensionar ou ocultar o painel lateral.

<div align="left"><figure><img src="https://1535499562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFuSXZSnkY0bm1EPoBQFD%2Fuploads%2FnzZZGrEbF9hE8etL86Kh%2Farvore.png?alt=media&amp;token=9f923269-408c-4407-9d22-afbdcb961aec" alt=""><figcaption></figcaption></figure></div>

3. **Área gráfica direita (timeline canvas)**:

* **Régua cronológica** com cabeçalhos de período (ano, mês, dia da semana e data).
* **Barras de tarefas**, linhas de dependência, marcadores de eventos pontuais (Checkpoints, Entregas) e sombreamento de fins de semana/dias não úteis.

<figure><img src="https://1535499562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFuSXZSnkY0bm1EPoBQFD%2Fuploads%2FqtMdEjGpkJB9nw8SoShZ%2F2026-11-03_15h42_14.png?alt=media&amp;token=e29b869d-4dd3-4a4c-94f6-49cb5a87f6c2" alt=""><figcaption></figcaption></figure>

#### 2. Especificação dos elementos

**2.1. Lista de tarefas (tree Grid / hierarquia recursiva)**

* **Estrutura recursiva**: Suporte a múltiplos níveis de agrupamento (macroprocessos, tarefas e subtarefas).
* **Ícones de expansão/Colapso**: Botões **+** e **-** que expandem ou recolhem dinamicamente os itens subordinados.
* **Ícones por registro**: Utilização de ícones temáticos de identificação (ex.: lápis, nuvem, globo, calendário).
* **Badges de status**: Pílulas coloridas que refletem o estado atual da tarefa:
* Em andamento (azul)
* Finalizado (verde)
* Parado / Em espera (vermelho)

<div align="left"><figure><img src="https://1535499562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFuSXZSnkY0bm1EPoBQFD%2Fuploads%2F7h9mhcaDb54S7VEiajGK%2Fem%20andamento.png?alt=media&amp;token=ce57ef48-1345-41b5-b356-a7e09bdfca14" alt=""><figcaption></figcaption></figure></div>

**2.2. Linha do tempo e barras de duração**

* **Barras de execução**: Representam o intervalo entre a data de início e término da tarefa.
* **Indicador de progresso interno**: Preenchimento visual em dois tons dentro da própria barra (ex.: azul escuro preenchendo a porcentagem executada sobre o fundo azul claro).
* **Rótulo interno**: Texto embutido na barra identificando o time, responsável ou categoria.
* **Manipulação direta** (interatividade drag & drop):

  * **Arrastar (mover)**: Desloca o início e o término da atividade mantendo a duração.
  * **Redimensionar (resize)**: Ajusta a data final ou inicial puxando as extremidades da barra.
  * **Navegação livre na grade (Arraste de tela):** Permite rolar e navegar horizontalmente e verticalmente pela linha do tempo clicando e arrastando o cursor a partir de qualquer área em branco da grade. Essa funcionalidade dispensa a dependência exclusiva da barra de rolagem, proporcionando deslocamento fluido pelo cronograma.

  <figure><img src="https://1535499562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFuSXZSnkY0bm1EPoBQFD%2Fuploads%2FJ8aCIHMZonwvSvcLYmHd%2Fgantt%20ajustado.png?alt=media&amp;token=8e5d5c99-2767-4360-b326-4d1196af1eb2" alt=""><figcaption></figcaption></figure>
* **Memorização de Posição:** A última posição de rolagem horizontal visualizada pelo operador é salva automaticamente vinculada à data/hora exibida em tela, garantindo que o cronograma reabra exatamente no mesmo ponto de interesse em acessos posteriores.
* **Menu de contexto do item:** Botão de ação (três pontos verticais **⋮**) na extremidade do bloco para ações rápidas de "abrir" (detalhamento) ou "concluir".

<figure><img src="https://1535499562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFuSXZSnkY0bm1EPoBQFD%2Fuploads%2FiWxy4FIIM24JxWA8I3E3%2Fabrir.png?alt=media&amp;token=506e5093-1e0b-425f-b57c-4e02afc14daf" alt=""><figcaption></figcaption></figure>

**2.3. Relações de dependência e conectores**

* **Linhas de Dependência (Gantt Links)**: Setas direcionadas que conectam o término de uma tarefa antecessora ao início da sucessora (relação Finish-to-Start), recalculando visualmente os impactos em cadeia ao movimentar itens.

<figure><img src="https://1535499562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFuSXZSnkY0bm1EPoBQFD%2Fuploads%2FdpJAgxUtyAVhPSi15dTS%2Fde%20para.png?alt=media&amp;token=287880d6-d32d-4764-bcdd-83114b7771bd" alt=""><figcaption></figcaption></figure>

**2.4. Marcadores globais e linhas de marco (milestones)**

* **Linhas verticais com tags**: Linhas que atravessam verticalmente todas as linhas da tabela temporal demarcando datas críticas:
* **Linha de checkpoint**: Tag destacada no topo (laranja) demarcando reuniões de validação ou portões de fase.
* **Linha de entrega**: Tag de encerramento ou deadline final (vermelha com ícone de bandeira).

Podem ser utilizadas também para destacar a data/hora inicial ou a posição de referência definida pela rotina por meio de uma linha vertical na grade.

<figure><img src="https://1535499562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFuSXZSnkY0bm1EPoBQFD%2Fuploads%2F40RwwNOdW8wbXMb7iL5I%2F2026-11-03_15h58_25.png?alt=media&amp;token=dc3e5581-e761-462a-8d14-48f1aa09ba7f" alt=""><figcaption></figcaption></figure>

**2.5. Popover informativo**

Ao interagir com um registro ou barra, uma janela flutuante exibe os metadados cadastrais:

* **Responsável:** Nome do operador associado.
* **Briefing / documentos:** Link de acesso rápido ao documento anexado.
* **Cor principal:** Indicador visual da cor aplicada ao item na grade.
* **Indicador de prazo**: Tag com validação visual de conformidade (Atrasada / No prazo).
* **Prioridade**: Marcador de criticidade (ex.: bandeira com indicador Alta).
* **Observação**: Campo de texto livre com notas da tarefa.

<figure><img src="https://1535499562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFuSXZSnkY0bm1EPoBQFD%2Fuploads%2FAytgtAoqcvnFmjxLhBn4%2Fjanela.png?alt=media&amp;token=c995b3af-569b-4c0e-8f25-a7f3e45eb65d" alt=""><figcaption></figcaption></figure>

**2.6. Preferências do usuário**

Para aumentar a produtividade e evitar que o usuário precise reconfigurar a visualização a cada acesso, o Gantt armazena as preferências de navegação de forma personalizada:

**Visão e posição salvas:** O sistema grava automaticamente a granularidade selecionada (ex.: semana, mês) e a data/hora visível na área útil da tela.

**Posicionamento responsivo:** A posição de rolagem é armazenada com base na data/hora visível, e não em coordenadas de pixels. Dessa forma, caso a resolução da tela, o redimensionamento do painel ou a escala sofram alterações, a tela continuará ancorada no instante temporal correto.

**Comportamento fora do intervalo:** Caso a data salva nas preferências (ou predefinida pela aplicação) esteja fora do período total configurado para a timeline, o cursor posicionará a exibição no limite válido mais próximo (início ou fim do cronograma).

**Ordem de precedência na abertura:** Ao carregar o Gantt, a visualização e a data/hora de abertura seguem a seguinte prioridade:

**Preferência salva do usuário:** Mantém o último estado em que o operador deixou o componente.

**Configuração da aplicação:** Parâmetros definidos pelo programa chamador no ERP (caso o usuário não tenha histórico salvo).

**Padrão do programa:** Escala em "Dia" posicionado no início do período total da timeline.

#### 3. Painel analítico integrado (Aba Resumo)

A aba de resumo consolida os indicadores globais gerados a partir dos dados do gráfico Gantt:

| Bloco de Indicador           | Tipo de Dado / Exibição        | Finalidade                                                                                                                                |
| ---------------------------- | ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------- |
| **KPIs em Cards Superiores** | Valores numéricos pontuais     | Exibe contadores rápidos de Grupos, Total de itens, tarefas Concluídas, Em andamento, Pausadas, Atrasadas e a taxa global de % Concluído. |
| **Distribuição por Status**  | Gráfico de Rosca (Donut Chart) | Representação percentual das atividades segmentadas por status (Concluídas, Em andamento, Pausadas).                                      |
| **Progresso Geral**          | Barra de progresso linear      | Visão consolidada da evolução percentual do projeto em relação à meta global (ex.: 66%).                                                  |
| **Período e Duração**        | Cards informativos             | Exibe o intervalo total analisado (Data Inicial -> Data Final) e a duração total em dias.                                                 |

<figure><img src="https://1535499562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFuSXZSnkY0bm1EPoBQFD%2Fuploads%2FDjyF2cTqV3nTCGrJnSCg%2F2026-11-03_14h48_44.png?alt=media&amp;token=4d76edd8-06e5-422e-9844-a7ad731c469d" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://ajuda.consistem.com.br/tecnologia/erp/componentes/funcionalidades/gantt.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
