Manual do Usuário
Manual completo de uso do sistema SIGMA-PLI.
1. O que é o SIGMA-PLI?
O SIGMA-PLI (Sistema Integrado de Gestão, Monitoramento e Apoio Técnico ao Plano de Logística e Investimentos do Estado de São Paulo — PLI/SP) constitui o repositório estruturado do conhecimento técnico produzido no âmbito do PLI. Trata-se de uma plataforma concebida para armazenar, organizar e disponibilizar, de forma sistemática, todo o acervo técnico gerado ao longo da execução do plano.
A diretriz fundamental que orienta o SIGMA-PLI estabelece que todo arquivo incorporado ao acervo deve estar obrigatoriamente catalogado em um cadastro estruturado de metadados. Cada arquivo é descrito de forma detalhada quanto ao seu conteúdo, autoria, data de produção, estrutura de armazenamento de dados, entre outros atributos. Essa organização permite a compreensão imediata do acervo sem a necessidade de inspeção individual dos arquivos, ao mesmo tempo que assegura rastreabilidade, auditabilidade, transparência e governança sobre o conjunto das informações.
Com base nesse princípio, o sistema foi estruturado em quatro camadas interdependentes. O núcleo é composto pelo Repositório e pelo Catálogo de Arquivos: o SIGMA Drive é responsável pelo armazenamento físico dos arquivos, enquanto o Catálogo gerencia, estrutura e disponibiliza os metadados associados a cada item. A camada de gestão de usuários e controle de acesso garante que apenas indivíduos devidamente identificados e autorizados possam inserir, editar e consultar registros ou baixar arquivos, mantendo um histórico completo e auditável de todas as operações realizadas.
Adicionalmente, o grafo de relacionamentos modela as relações entre as diversas entidades associadas ao PLI, explicitando vínculos como a derivação entre produtos, a origem dos dados e o envolvimento institucional. Por fim, o módulo de WebGIS integrado provê a espacialização dos dados geoespaciais, permitindo a contextualização geográfica e a compreensão de sua aplicação no território do Estado de São Paulo.
2. Como o Sistema está Organizado
O SIGMA-PLI é construído de forma modular: cada grande funcionalidade vive em um espaço próprio, com sua lógica e seu público-alvo. Entender essa organização facilita encontrar o que se precisa e compreender por que certas funções exigem permissões específicas. Dentro desse contexto, o acesso se divide em dois níveis: o acesso aberto, sem necessidade de cadastro, que permite consultar a plataforma, o repositório e o catálogo; e o acesso restrito, que exige conta aprovada e habilita participação ativa — envio de arquivos, edição de registros e gestão de usuários.
A porta de entrada e o acervo disponível
A página inicial — disponível sem cadastro em /plataforma — apresenta
o projeto PLI/SP, informa o status dos serviços em tempo real e oferece formulário de contato.
Nenhum cadastro é necessário para acessá-la. A partir dali, qualquer pessoa do público-alvo pode
navegar até o SIGMA Drive e ao Catálogo de Arquivos, os dois
ambientes de consulta do repositório de dados disponíveis sem login.
O coração do sistema: repositório, catálogo e upload
O módulo M03 concentra as funcionalidades mais importantes do SIGMA. O
SIGMA Drive (/storage) é o repositório físico dos arquivos — é onde
eles vivem depois de enviados. O Catálogo de Arquivos
(/storage/catalogo) é sua face documental: expõe os metadados detalhados de cada
registro — perfil, tema, estrutura, procedência, responsável — e é a principal ferramenta de
consulta do acervo técnico do PLI.
Para depositar arquivos, é preciso ter no mínimo o papel de ANALISTA e
utilizar o Upload Inteligente (/storage/upload-inteligente), que
conduz o usuário em cinco etapas guiadas, ou o Assistente de Upload em Lote
para envios múltiplos. O Editor de Catálogo permite revisar e corrigir metadados
de registros já existentes.
Identidade e controle de acesso
Para participar ativamente — enviando arquivos, editando registros, gerenciando usuários — é necessário ter uma conta registrada e aprovada. O módulo de autenticação (M01) cuida de todo esse ciclo: cadastro com verificação de e-mail, aprovação por um gestor ou administrador, login, recuperação de senha e encerramento de sessão. A autenticação utiliza tokens JWT com sessões de 30 minutos, renováveis sem necessidade de novo login.
Área pessoal, relatórios e análises
Uma vez autenticado, cada usuário encontra sua Minha Área (M04), onde pode consultar e editar seus dados cadastrais, configurar preferências, receber notificações e acompanhar o calendário de atividades do PLI. O módulo de Relatórios (M06) oferece visões consolidadas sobre usuários e atividades, com exportação em CSV e Excel. O Hub de Ferramentas e Análises (M07) centraliza dashboards externos integrados ao PLI — incluindo FAD STATS, análise de acidentes rodoviários e quociente vocacional.
Inteligência espacial e relacional
O WebGIS — integrado ao M03 — permite visualizar no mapa os arquivos geoespaciais cadastrados no catálogo, situando cada dado dentro do território paulista. O Grafo Lógico (M09), alimentado pelo banco de grafos Memgraph, permite explorar as relações entre as entidades do PLI: como produtos, arquivos, instituições e etapas de execução se conectam e dependem uns dos outros. Juntos, esses dois módulos respondem às perguntas onde e como o conhecimento técnico do PLI se organiza.
Gestão e monitoramento
Administradores e gestores têm acesso ao Painel de Gestão (M08), de onde podem aprovar cadastros, gerenciar usuários de suas instituições e acompanhar a operação do sistema. O módulo de Monitoramento (MX), exclusivo para administradores, oferece visibilidade em tempo real sobre a saúde dos serviços, containers e infraestrutura da plataforma.
3. Como Navegar pelo Sistema
3.1 A página inicial
Ao acessar /plataforma, você verá a landing page do projeto com uma breve
apresentação do PLI/SP, o painel de status dos serviços em tempo real, atalhos para os principais
módulos e um formulário de contato. Essa página não exige autenticação e é o ponto de partida
recomendado para novos usuários.
3.2 O menu muda conforme seu perfil
Uma das características do SIGMA é que o menu de navegação superior se adapta automaticamente ao tipo de usuário. Visitantes sem login vêem apenas os recursos públicos. Usuários autenticados têm acesso aos módulos correspondentes ao seu nível de permissão. Gestores e administradores vêem seções adicionais de gestão e auditoria. Essa adaptação é automática — não é necessário configurar nada.
Visitante (não autenticado) — barra pública
| Item de Menu | Destino |
|---|---|
| Home | /plataforma |
| Cadastro | /cadastro |
| Dashboards e Análises | /ferramentas |
| Contato | /contato |
| Ajuda | /ajuda |
VISUALIZADOR / OPERADOR / ANALISTA — barra restrita
| Item de Menu | Destino |
|---|---|
| Home | /plataforma |
| Minha Área ▸ Painel do Analista | /app/dashboard |
| Minha Área ▸ Meus Dados | /app/meus-dados |
| Sigma Drive | /storage |
| Sigma Drive ▸ Lixeira | /dicionario/lixeira |
| Catálogo de Arquivos | /storage/catalogo |
| Catálogo de Arquivos ▸ Editor de Catálogo | /storage/editor-catalogo |
| Dashboards e Análises | /app/ferramentas |
| Dashboards e Análises ▸ FAD STATS | link externo (nova aba) |
| Dashboards e Análises ▸ Quociente Vocacional | /shiny/qv/ |
| Cadastro | /auth/cadastro |
| Relatórios ▸ Cadastros | /relatorios/cadastros |
| Relatórios ▸ Usuários | /relatorios/usuarios |
| Relatórios ▸ Dashboard | /relatorio |
GESTOR — barra do gestor
| Item de Menu | Destino |
|---|---|
| Home | /plataforma |
| Minha Área ▸ Dashboard Gestor | /gestor/dashboard |
| Minha Área ▸ Meus Dados | /app/meus-dados |
| Cadastro | /auth/cadastro |
| Dashboards e Análises ▸ Hub de Ferramentas | /app/ferramentas |
| Dashboards e Análises ▸ GeoServer | /geoserver/web/ |
| Auditoria | /admin/auditoria |
| Relatórios ▸ Cadastros | /relatorios/cadastros |
| Relatórios ▸ Usuários | /relatorios/usuarios |
| Relatórios ▸ Dashboard | /relatorio |
| Ajuda | /ajuda |
ADMIN — barra administrativa
| Item de Menu | Destino |
|---|---|
| Home | /plataforma |
| Minha Área ▸ Dashboard | /admin/panel |
| Minha Área ▸ Meus Dados | /app/meus-dados |
| Cadastro | /auth/cadastro |
| Dashboards e Análises ▸ Hub de Ferramentas | /app/ferramentas |
| Dashboards e Análises ▸ GeoServer | /geoserver/web/ |
| Relatórios ▸ Cadastros | /relatorios/cadastros |
| Relatórios ▸ Usuários | /relatorios/usuarios |
| Relatórios ▸ Dashboard | /relatorio |
| Admin ▸ Monitoramento | /sigma/monitoramento |
| Admin ▸ Quick Status | /sigma/quick |
| Admin ▸ Status da VM | /sigma/vm-saude |
| Admin ▸ Configuração de Serviços | /sigma/servicos-config |
| Admin ▸ Auditoria e Logs | /admin/auditoria |
| Ajuda | /ajuda |
3.3 A barra de sessão
Usuários autenticados vêem uma barra de sessão fixada abaixo da navbar. Ela informa o ID do usuário, o username, o nome completo e o tipo de conta, além de mostrar um contador regressivo do tempo restante de sessão. Por padrão, sessões expiram após 30 minutos de inatividade. Antes de expirar, o botão "Renovar sessão" estende o prazo sem exigir novo login.
4. Sua Conta no SIGMA
4.1 Como criar uma conta
O cadastro é feito pelo formulário em /cadastro. Nele, você informa seus dados
pessoais — nome completo e CPF, que é armazenado de forma criptografada (AES-256-GCM) —,
define username, e-mail institucional e senha, e declara os dados institucionais: instituição,
cargo e telefone. É necessário também selecionar o tipo de acesso desejado e aceitar os Termos
de Privacidade e de Uso.
Após enviar o formulário, você receberá um e-mail de verificação válido por 24 horas. Clicando no link, confirma seu endereço e coloca a solicitação na fila de aprovação. Um administrador ou gestor revisa o pedido e ativa a conta — você é notificado por e-mail quando isso acontece.
4.2 Como fazer login
Na tela de login, informe seu username ou e-mail institucional junto com a senha e clique em "Entrar". O sistema aceita ambas as formas de identificação. Por segurança, após 5 tentativas falhas em um minuto, a conta é temporariamente bloqueada.
4.3 O que fazer se esquecer a senha
Na tela de login, clique em "Esqueceu a senha?". Informe seu e-mail institucional e o tipo de usuário da sua conta. Você receberá um link de redefinição de senha válido por tempo limitado. Ao defini-la, utilize no mínimo 8 caracteres combinando maiúsculas, minúsculas, números e caracteres especiais.
4.4 Como alterar a senha
Acesse Minha Área → Meus Dados (/app/meus-dados) e clique em
"Alterar senha". Informe a senha atual e a nova senha. Após a confirmação, todas as sessões
ativas da sua conta são encerradas automaticamente por segurança — será necessário fazer login
novamente.
5. Minha Área
A Minha Área é o espaço pessoal de cada usuário autenticado dentro do SIGMA. É dali que se gerenciam os dados cadastrais, se configuram preferências, se recebem notificações e se acompanha a agenda de atividades do PLI.
Em Meus Dados (/app/meus-dados), você pode visualizar e editar
suas informações pessoais e institucionais, além de alterar a senha. Em
Preferências (/app/preferencias), é possível ajustar
configurações de exibição e comportamento do sistema. A seção de
Notificações (/app/notificacoes) reúne alertas e comunicados
relevantes gerados pela plataforma. O Calendário
(/app/calendario) exibe eventos e atividades relacionados ao PLI.
O painel principal — acessado pelo logo da navbar após o login — varia conforme o perfil:
ANALISTAs vão para o Painel do Analista (/app/dashboard), GESTOREs para o
Dashboard Gestor (/gestor/dashboard) e ADMINs para o Painel Administrativo
(/admin/panel).
6. Repositório de Dados do PLI
6.1 O que é e como funciona
O Repositório de Dados do PLI (M03) é o espaço central onde o acervo técnico do plano é depositado, documentado e consultado. Sua arquitetura separa intencionalmente o armazenamento físico dos arquivos da sua documentação, garantindo que cada arquivo tenha não apenas um lugar onde viver, mas uma identidade completa dentro do sistema.
O SIGMA Drive (/storage) é o repositório físico: é onde os
arquivos efetivamente residem após o upload. Sua interface permite navegar pelo acervo, fazer
buscas e visualizar os arquivos disponíveis. Já o Catálogo de Arquivos
(/storage/catalogo) é a camada documental: cada arquivo registrado tem uma entrada
no catálogo com metadados detalhados — perfil de dado, tema, periodicidade, procedência,
estrutura interna, responsável técnico e palavras-chave. É a interface de consulta e pesquisa
do acervo, acessível publicamente sem necessidade de login.
6.2 Como depositar um arquivo: o Upload Inteligente
Para registrar um novo arquivo no sistema, é necessário ter o papel de ANALISTA ou superior. O processo é conduzido por um assistente em cinco etapas. Na primeira, o arquivo é selecionado e validado quanto à extensão e ao tamanho (máximo de 500 MB); um hash é calculado para garantir integridade. Na segunda, o usuário informa o nome oficial do arquivo, o produto PLI ao qual se vincula, uma descrição e palavras-chave. Na terceira, campos de estrutura técnica são preenchidos — muitos são extraídos automaticamente pelo sistema ao analisar o conteúdo do arquivo. Na quarta, informam-se os metadados de contexto: tema, periodicidade, metodologia e série histórica. Na quinta etapa, tudo é revisado e confirmado; o arquivo sobe para o storage, é registrado no banco de dados e, se for um dado geoespacial, é automaticamente publicado no GeoServer para disponibilização no WebGIS.
Para envios em volume, o Assistente de Upload em Lote
(/dicionario/batch-upload) permite registrar múltiplos arquivos de uma só
vez. Metadados já catalogados podem ser revisados e corrigidos a qualquer momento pelo
Editor de Catálogo (/storage/editor-catalogo).
Consulte o Guia de Upload de Dados para instruções passo a passo detalhadas sobre o processo completo.
6.3 Perfis de arquivo: como o sistema classifica seus dados
Todo arquivo registrado no SIGMA é classificado em um de dez perfis. Essa classificação determina quais campos de metadado serão exibidos e quais informações o sistema tentará extrair automaticamente. Os perfis são: database (bases de dados), desenho_2d3d (arquivos CAD e modelos), documentos_texto (PDFs, relatórios, DOCXs), geodatabase (bases geoespaciais estruturadas), geoespacial_raster (imagens e grids georeferenciados), geoespacial_vetor (shapefiles, GeoJSON, camadas vetoriais), midia (imagens, vídeos, áudios), nuvem_pontos (arquivos LAS/LAZ), pacote (ZIPs e arquivos compostos) e tabular (planilhas, CSVs, dados estruturados em linha-coluna). O correto preenchimento do perfil é fundamental para a qualidade do catálogo.
7. WebGIS
O WebGIS do SIGMA (/dicionario/webgis) é o ambiente de visualização geoespacial
integrado ao repositório. Quando um arquivo geoespacial é depositado no sistema, ele é
automaticamente publicado no GeoServer e passa a estar disponível como camada no WebGIS. Isso
significa que o mapa sempre reflete o que está no catálogo — não é uma coleção separada de
dados, mas uma janela visual sobre o próprio acervo do PLI.
Na interface, o painel lateral exibe as camadas disponíveis agrupadas por tipo. Você ativa e desativa camadas individualmente, alterna entre diferentes mapas base (OpenStreetMap, satélite e topográfico) e navega pelo mapa com mouse ou toque. Ao clicar sobre uma feição, informações dos atributos do arquivo são exibidas em um painel de detalhes. O WebGIS também oferece ferramentas de medição de distâncias e áreas, além do modo tela cheia. Para uma explicação completa de todas as funcionalidades, consulte o Guia do SIGMA-WebGIS.
8. Relatórios
O módulo de Relatórios (M06) oferece visões consolidadas sobre a atividade no sistema,
voltadas para usuários com papel de ANALISTA ou superior. O
Relatório de Usuários (/relatorios/usuarios) exibe
estatísticas e listagens dos usuários cadastrados no sistema, com filtros por tipo, status
e instituição. O Relatório de Cadastros
(/relatorios/cadastros) consolida os dados de pessoas físicas e instituições
registradas. O Dashboard de Relatórios (/relatorio) oferece
uma visão gráfica e resumida das principais métricas. Todos permitem exportação em
CSV e Excel para uso externo.
9. Tipos de Usuário e Permissões
O SIGMA adota um modelo hierárquico de cinco níveis de permissão. O nível define o que cada usuário pode fazer dentro do sistema — e, por consequência, quais menus e funcionalidades são visíveis para ele. Ao solicitar cadastro, o usuário escolhe o nível desejado; a aprovação caberá a um gestor ou administrador.
O VISUALIZADOR (nível 1) pode consultar dados públicos e acessar sua Minha Área. O OPERADOR (nível 2) tem acesso ampliado ao catálogo e ao repositório, mas ainda não pode enviar arquivos. O ANALISTA (nível 3) ganha a capacidade de realizar uploads, editar o catálogo, exportar relatórios e utilizar as ferramentas analíticas — é o nível mínimo para quem produz ou entrega dados ao PLI. O GESTOR (nível 4) tem todas as capacidades do ANALISTA, além do Painel Gestor para gerenciar os usuários da sua instituição, aprovar cadastros e acessar logs de auditoria. O ADMIN (nível 5) tem acesso total: gerencia todos os usuários e instituições, configura serviços, monitora a infraestrutura e tem visibilidade completa sobre todos os logs e atividades do sistema.
| Papel | Nível | Capacidades principais |
|---|---|---|
| VISUALIZADOR | 1 | Consulta pública, Minha Área |
| OPERADOR | 2 | + acesso ampliado ao catálogo e repositório |
| ANALISTA | 3 | + upload, edição de catálogo, relatórios, ferramentas |
| GESTOR | 4 | + Painel Gestor: aprovar cadastros, gerenciar usuários da instituição |
| ADMIN | 5 | Acesso total: Painel ADM, monitoramento, configuração de serviços |
10. Precisa de Ajuda?
Se tiver dúvidas sobre o funcionamento do sistema, encontrar um problema ou quiser sugerir melhorias, utilize a página de Contato. Descreva com o máximo de detalhe possível o que aconteceu: o que você estava tentando fazer, qual mensagem de erro apareceu (se houver), qual navegador e sistema operacional usa. Capturas de tela ajudam muito no diagnóstico.
Para as situações mais comuns, consulte os guias específicos disponíveis na Central de Ajuda. O sistema funciona melhor em Chrome, Firefox ou Edge nas versões mais recentes. Lembre-se que sessões expiram após 30 minutos de inatividade — use o botão "Renovar sessão" na barra de sessão para estender sem precisar fazer login novamente.