1. Acesso e identidade
Login pelo código individual institucional, confirmação obrigatória do cargo e sessão em cookie de 12 h (um turno). O cargo define a camada de visão: própria, operacional ou estratégica.
Documentação Institucional • Terminal STS-01 • Ícones por unDraw
Como funciona o sistema NexusPort
O NexusPort é a plataforma de gestão operacional do Terminal STS-01 (Porto de Santos). Ele acompanha a carga desde o agendamento até a entrega no porto de destino, formaliza a inspeção técnica de recebimento, controla o pátio, os equipamentos e as embarcações e mantém uma trilha auditável de todas as decisões críticas tomadas no terminal.
- 11páginas no sistema
- 10cargos com visões distintas
- 7pilares operacionais
- 9status no fluxo da carga
O acesso ao sistema é controlado por perfil funcional (RBAC), garantindo que cada cargo visualize e execute apenas as operações compatíveis com sua função no terminal.
Fluxo operacional, do agendamento à auditoria
Cada pilar abaixo corresponde a uma etapa da operação portuária no terminal: identidade, entrada da carga, inspeção técnica, armazenagem no pátio, despacho marítimo, comando executivo e operação em campo.
2. Agendamento e recebimento
A carga entra em AGENDAMENTO com data prevista de entrega e destino; no recebimento é conferida contra o checklist do tipo de carga e recebe QR Code com etiqueta A4.
3. Inspeção formal
O inspetor executa o checklist item a item. A aprovação só é liberada quando 100% dos itens críticos estão conformes (RN 14); a recusa exige motivo formal, que vai para a auditoria.
4. Pátio e vínculo
Aprovada, a carga é armazenada em baia e vinculada a contêiner e navio. O sistema mantém berços, guindastes e a localização das embarcações com ETA por rota a partir do Porto de Santos.
5. Despacho e liberação
O supervisor (ou o substituto delegado) libera a saída, cancela entregas e responde por decisões que ficam registradas na trilha imutável com justificativa formal.
6. Comando e auditoria
O painel consolida KPIs e gráficos por camada de visão; toda alteração relevante vai para logs_alteracoes e toda decisão crítica para trail_decisoes com retificações anexáveis.
7. Operação em campo
O leitor de QR Code funciona no celular: leitura por câmera ou digitação, com registro da leitura. O botão de pânico é global e propaga o alerta em tempo real para todas as telas.
Esteira de status da carga
- AGENDAMENTOData prevista de entrega e destino registrados.
- RECEBIMENTO_INSPECAOCarga na guarita, aguardando conferência.
- ARMAZENAGEMInspecionada e guardada na baia do pátio.
- PRONTA_PARA_ENTREGAArrumada e liberada para embarque.
- SAIDAEm saída do terminal, com etiqueta e QR conferidos.
- EM_TRANSITOEmbarcada e a caminho do porto de destino.
- ENTREGUEEntrega confirmada no destino.
- CANCELADACancelamento autorizado e registrado (sem retorno ao fluxo).
- RECUSADAReprovada na inspeção, com motivo formal.
Como o sistema é construído
O NexusPort é um front-end estático que conversa diretamente com o Supabase (PostgREST, Realtime e Edge Functions). As regras de negócio são aplicadas nas telas, nas políticas do banco e nas funções de borda.
Front-end estático e acessível
- HTML5 + Tailwind CSS + JavaScript ES6 (módulos por página em js/pages/).
- CSS compilado localmente (css/nexus.css) e fontes auto-hospedadas, sem dependência de CDNs externos.
- Bibliotecas locais sob demanda: Chart.js (gráficos), qrcode.js (etiquetas) e html5-qrcode (leitura por câmera).
- Layout compartilhado em js/layout.js (topbar, menu retrátil, tema claro/escuro, presença em tempo real e integração de acessibilidade VLibras).
Supabase (PostgreSQL + PostgREST)
- Acesso direto ao PostgREST com políticas RLS que controlam o que cada consulta enxerga.
- Tabelas operacionais: funcionarios, cargas, containers, navios, bercos, guindastes, manutencoes, inspecoes, visitantes.
- Auditoria em logs_alteracoes (append-only) e decisões em trail_decisoes + retificacoes_trail.
- Realtime (WebSocket) sincroniza as telas quando um registro muda e sustenta o alarme do botão de pânico.
Edge Functions (Deno)
- panic-alert: recebe o acionamento, grava a emergência e publica o alerta no Realtime.
- relatorio-pdf: gera o PDF A4 no servidor (pdf-lib) e guarda o arquivo em bucket privado com cache por hash.
- despacho-embarcacao e kpis-calculo: apoio ao despacho e aos indicadores consolidados.
- scanner-qr: valida leituras de QR Code dos ativos.
Segurança e conformidade
- RBAC por cargo: a matriz de ações (ACTION_PERMISSIONS) e a de páginas (PAGE_PERMISSIONS) ficam em js/auth-guard.js.
- Anti-XSS: toda saída de dado passa por nexusEsc/nexusJsArg (js/security.js).
- LGPD: o GA4 não recebe dados pessoais; eventos levam apenas categorias operacionais.
- Trilha imutável: correções são anexadas como retificação, nunca sobrescrevem a decisão original.
Camadas de visão
- Visão Própria: Estivador, Conferente, Arrumador, Planejador e Técnico em Portos veem a própria operação.
- Visão Operacional: Inspetor e Supervisor enxergam o fluxo do terminal, inspeções e manutenções.
- Visão Estratégica: Diretor de Operações, Diretor-Presidente e Conselho acessam indicadores financeiros e de produtividade.
WebMCP (agentes de IA)
- Ferramentas expostas em document.modelContext com o mesmo RBAC das telas.
- Ações que mudam estado exigem confirmação humana explícita na tela.
- Integração nativa com os formulários e tabelas operacionais de cada página.
Regras de negócio que sustentam o fluxo
| Regra | Como aparece no sistema |
|---|---|
| RN 14 — Inspeção | Aprovar carga exige 100% dos itens críticos conformes; qualquer item não conforme bloqueia a aprovação e habilita a recusa com motivo. |
| RN 15 — Credencial | Perda ou esquecimento invalida o código individual anterior, reemitido presencialmente pelo Técnico em Portos. |
| RN 12 — Cascata de status | A mudança da localização do navio propaga o status das cargas vinculadas no banco: EM_TRANSITO ↔ ENTREGUE. |
| RF 12/13 — Auditoria | Toda alteração entra em logs_alteracoes e toda decisão crítica em trail_decisoes, com retificações anexadas em vez de exclusão. |
| RF 14 — Delegação | No máximo um substituto ativo por supervisor, com vigência explícita e revogação registrada. |
| Emergência | Qualquer funcionário autenticado pode acionar o botão de pânico; o alerta chega a todas as telas conectadas e é registrado em emergencias. |
Perfis, camadas de visão e acessos
O cargo vem do cadastro funcional e não pode ser trocado na tela: ao confirmar, o operador assume a
camada de visão correspondente. As páginas abaixo são as liberadas para cada cargo pela matriz
PAGE_PERMISSIONS de js/auth-guard.js.
| Cargo | Nível | Camada de visão | Telas liberadas |
|---|---|---|---|
| Diretor-Presidente/Superintendente | Nível Estratégico | Visão Estratégica | Confirmação de Cargo · Painel de Comando · Cargas & Operações de Pátio · Inspeção · QR Code · Embarcações & Equipamentos · Manutenção · Delegação de Supervisor · Gestão de Pessoas (Técnico em Portos) · Relatórios & PDF |
| Diretor de Operações e Logística | Nível Estratégico | Visão Estratégica | Confirmação de Cargo · Painel de Comando · Cargas & Operações de Pátio · Inspeção · QR Code · Embarcações & Equipamentos · Manutenção · Delegação de Supervisor · Gestão de Pessoas (Técnico em Portos) · Relatórios & PDF |
| Conselho de Administração | Nível Estratégico | Visão Estratégica | Confirmação de Cargo · Painel de Comando · Cargas & Operações de Pátio · Inspeção · QR Code · Embarcações & Equipamentos · Manutenção · Delegação de Supervisor · Gestão de Pessoas (Técnico em Portos) · Relatórios & PDF |
| Supervisor / Gerente de Operações | Nível Gestão | Visão Operacional | Confirmação de Cargo · Painel de Comando · Cargas & Operações de Pátio · Inspeção · QR Code · Embarcações & Equipamentos · Manutenção · Delegação de Supervisor · Relatórios & PDF |
| Inspetor | Nível Tático | Visão Operacional | Confirmação de Cargo · Painel de Comando · Cargas & Operações de Pátio · Inspeção · QR Code · Embarcações & Equipamentos · Manutenção · Relatórios & PDF |
| Técnico em Portos | Nível Operacional | Visão Própria | Confirmação de Cargo · Painel de Comando · Gestão de Pessoas (Técnico em Portos) |
| Estivador | Nível Operacional | Visão Própria | Confirmação de Cargo · Painel de Comando · Cargas & Operações de Pátio · QR Code · Embarcações & Equipamentos · Manutenção |
| Conferente de Carga | Nível Operacional | Visão Própria | Confirmação de Cargo · Painel de Comando · Cargas & Operações de Pátio · Inspeção · QR Code · Relatórios & PDF |
| Arrumador e Consertador | Nível Operacional | Visão Própria | Confirmação de Cargo · Painel de Comando · Cargas & Operações de Pátio · Manutenção |
| Planejador de Pátio e de Navios | Nível Operacional | Visão Própria | Confirmação de Cargo · Painel de Comando · Embarcações & Equipamentos · Manutenção |
Funcionalidades de cada página do sistema
Abaixo está cada página do NexusPort com sua finalidade operacional, suas funcionalidades principais e os cargos que possuem permissão de acesso.
index.html
Autenticação de Funcionário
Código individual único (matrícula)
Estivador
Conferente de Carga
Arrumador e Consertador
Planejador de Pátio e de Navios
+6
Porta de entrada do sistema. O operador informa o código individual vinculado à matrícula; o sistema valida no cadastro do terminal e encaminha para a confirmação de cargo.
Funcionalidades principais
- Validação por código individual ou matrícula (nexus_code_overrides cobre códigos reemitidos).
- Contingência RN 15: pedido de reemissão de credencial com o procedimento presencial na Guarita Central.
- Tema claro/escuro e feedback inline (credencial reconhecida, código invalidado, credencial inexistente).
Tela pública (etapa de autenticação — não exige sessão prévia)
confirm-role.html
Confirmação de Cargo
Etapa obrigatória antes do painel
Estivador
Conferente de Carga
Arrumador e Consertador
Planejador de Pátio e de Navios
+6
Mostra o cargo, o nível de acesso e a camada de visão que a sessão receberá. O cargo não é editável: vem do cadastro funcional, conforme o RF 1.
Funcionalidades principais
- Sessão gravada em cookie de 12 h (turno operacional) somente após a confirmação.
- Metadados por cargo definem a camada de visão: Própria, Operacional ou Estratégica.
- Tentativa de troca manual de cargo é bloqueada pela guarda de autenticação.
Cargos com acesso: Estivador, Conferente de Carga, Arrumador e Consertador, Planejador de Pátio e de Navios, Técnico em Portos, Supervisor / Gerente de Operações, Inspetor, Diretor de Operações e Logística, Diretor-Presidente/Superintendente, Conselho de Administração
dashboard.html
Painel de Comando
KPIs, gráficos por camada de visão e trilha de decisões
Estivador
Conferente de Carga
Arrumador e Consertador
Planejador de Pátio e de Navios
+6
Visão geral do terminal: indicadores, gráficos recortados pela camada de visão do cargo, atividade recente da auditoria e trilha imutável de decisões.
Funcionalidades principais
- Indicadores calculados a partir das cargas, contêineres, navios e manutenções reais.
- Gráficos (Chart.js) mudam conforme o cargo: própria, operacional ou estratégica.
- Valor declarado é restrito à Visão Estratégica; dados pessoais não aparecem para cargos táticos.
Cargos com acesso: Estivador, Conferente de Carga, Arrumador e Consertador, Planejador de Pátio e de Navios, Técnico em Portos, Supervisor / Gerente de Operações, Inspetor, Diretor de Operações e Logística, Diretor-Presidente/Superintendente, Conselho de Administração
cargas.html
Cargas & Operações de Pátio
Agendamento, recebimento, armazenagem e vínculo com navio/contêiner
Estivador
Conferente de Carga
Arrumador e Consertador
Supervisor / Gerente de Operações
+4
Coração do fluxo operacional: cadastro e acompanhamento das cargas nos 9 status, do agendamento à entrega, com checklist de avarias, QR Code e etiqueta A4.
Funcionalidades principais
- Esteira de status: AGENDAMENTO → RECEBIMENTO_INSPECAO → ARMAZENAGEM → PRONTA_PARA_ENTREGA → SAIDA → EM_TRANSITO → ENTREGUE (e CANCELADA/RECUSADA).
- Vínculo com contêiner, navio e estivador responsável; QR Code gerado em canvas e etiqueta 10×10 cm para impressão.
- Busca com filtros combinados e contadores por status.
Cargos com acesso: Estivador, Conferente de Carga, Arrumador e Consertador, Supervisor / Gerente de Operações, Inspetor, Diretor de Operações e Logística, Diretor-Presidente/Superintendente, Conselho de Administração
inspecao.html
Inspeção
Conformidade técnica com resultado auditável
Conferente de Carga
Inspetor
Supervisor / Gerente de Operações
Diretor de Operações e Logística
+2
Execução do checklist técnico de recebimento: cada item é marcado como conforme ou não conforme e a inspeção é concluída como aprovada ou recusada.
Funcionalidades principais
- Checklist por tipo de carga (checklist_modelos/checklist_itens) com itens críticos.
- Inspeção ativa única por carga: as anteriores permanecem como histórico.
- Leitura do QR Code da carga direto na tela para abrir a inspeção correspondente.
Cargos com acesso: Conferente de Carga, Inspetor, Supervisor / Gerente de Operações, Diretor de Operações e Logística, Diretor-Presidente/Superintendente, Conselho de Administração
scanner.html
QR Code
Leitura móvel por câmera ou entrada manual
Estivador
Conferente de Carga
Supervisor / Gerente de Operações
Inspetor
+3
Leitura de etiquetas QR das cargas. Aceita câmera do dispositivo ou digitação do código, com registro da leitura e histórico.
Funcionalidades principais
- Aceita o código impresso na etiqueta QR Code ou o identificador operacional do ativo.
- Fallback de digitação manual para ambientes sem câmera.
- Cada leitura é registrada em leituras_qr_code para rastreabilidade.
Cargos com acesso: Estivador, Conferente de Carga, Supervisor / Gerente de Operações, Inspetor, Diretor de Operações e Logística, Diretor-Presidente/Superintendente, Conselho de Administração
embarcacoes.html
Embarcações & Equipamentos
Atracação, berços, rotas e posição dos navios
Estivador
Planejador de Pátio e de Navios
Inspetor
Supervisor / Gerente de Operações
+3
Gestão das embarcações e do pátio: cadastro de navios e contêineres, estado operacional, berços do terminal, rotas marítimas e posicionamento GPS com ETA.
Funcionalidades principais
- 15 berços do STS-01 com estado LIVRE / OCUPADO / MANUTENCAO e vínculo com o navio atracado.
- Localização (dentro do porto, fora do porto, no porto de destino) atualiza o status das cargas vinculadas por gatilho no banco.
- Distância da rota e tempo de trânsito alimentam o cálculo de ETA.
Cargos com acesso: Estivador, Planejador de Pátio e de Navios, Inspetor, Supervisor / Gerente de Operações, Diretor de Operações e Logística, Diretor-Presidente/Superintendente, Conselho de Administração
manutencao.html
Manutenção
Abertura, aprovação e conclusão de OS
Estivador
Arrumador e Consertador
Planejador de Pátio e de Navios
Inspetor
+4
Ciclo de manutenção de navios, contêineres e guindastes: solicitação, aprovação ou recusa e conclusão, com histórico de serviços e o botão de pânico global no cabeçalho.
Funcionalidades principais
- Ordens de serviço por entidade (NAVIO, CONTAINER, GUINDASTE) com trilha de solicitação e aprovação.
- Conclusão de OS devolve o equipamento ao estado OPERANTE e grava o histórico.
- 🚨 Botão de pânico global disponível em todas as telas autenticadas.
Cargos com acesso: Estivador, Arrumador e Consertador, Planejador de Pátio e de Navios, Inspetor, Supervisor / Gerente de Operações, Diretor de Operações e Logística, Diretor-Presidente/Superintendente, Conselho de Administração
delegacao.html
Delegação de Supervisor
Substituto temporário com vigência e revogação
Supervisor / Gerente de Operações
Diretor de Operações e Logística
Diretor-Presidente/Superintendente
Conselho de Administração
Designa um substituto para o supervisor titular durante uma ausência, com janela de vigência, requalificação do cargo do substituto e revogação registrada na trilha.
Funcionalidades principais
- Enquanto a delegação está ativa, o substituto recebe as permissões do cargo de supervisor.
- Revogação imediata devolve o acesso original e grava a decisão na trilha imutável.
- Exige identificação do substituto (nome, CPF e data de nascimento) para auditoria.
Cargos com acesso: Supervisor / Gerente de Operações, Diretor de Operações e Logística, Diretor-Presidente/Superintendente, Conselho de Administração
tecnico_portos.html
Gestão de Pessoas (Técnico em Portos)
Funcionários, visitantes, documentos e reemissão de credencial
Técnico em Portos
Diretor de Operações e Logística
Diretor-Presidente/Superintendente
Conselho de Administração
Cadastro e manutenção do quadro funcional e dos visitantes, emissão de códigos individuais, controle de documentos e reemissão de credenciais (RN 15).
Funcionalidades principais
- Cadastro funcional com matrícula institucional, CPF validado e bloqueio de duplicidade.
- Registro de entrada e saída de visitantes com motivo da visita.
- Reemissão de código invalida o anterior e mantém a mesma matrícula.
Cargos com acesso: Técnico em Portos, Diretor de Operações e Logística, Diretor-Presidente/Superintendente, Conselho de Administração
relatorios.html
Relatórios & PDF
Busca operacional com 5 filtros e emissão de PDF A4
Conferente de Carga
Supervisor / Gerente de Operações
Inspetor
Diretor de Operações e Logística
+2
Busca operacional sobre as cargas com cinco filtros combinados, exportação de histórico e geração de relatório PDF A4 com o logotipo do terminal.
Funcionalidades principais
- Cinco filtros: identificador, status, natureza, período e porto de descarga.
- Relatório PDF A4 gerado no servidor (Edge Function relatorio-pdf) com cache por hash do conteúdo.
- Exportação de histórico com registro de auditoria da operação.
Cargos com acesso: Conferente de Carga, Supervisor / Gerente de Operações, Inspetor, Diretor de Operações e Logística, Diretor-Presidente/Superintendente, Conselho de Administração