Files
SGF/docs/HOME_NAVIGATION_PROPOSAL.md
T

7.8 KiB

Página inicial e navegação agrupada — proposta

28/10/2026. Primeiro passo de desenho solicitado pelo utilizador; sem alteração da aplicação. Preservar o ensaio aceite no checkpoint 04870f0 e anteriores. A migração 110000, sete concessões e utilização real continuam por autorizar. Este mapa não cria funcionalidades, direitos ou acesso operacional.

Base actual conferida no código

resources/js/app.jsx apresenta uma lista lateral plana, filtrada pelas concessões do contexto, e destaca a página seleccionada. A página inicial tem saudação e dois cartões: empresa e unidade. O cabeçalho mostra o contexto, com selectores de empresa/unidade antes do conteúdo. Os módulos de ensaio apresentam avisos próprios; não há hoje uma lista agregada de tarefas pendentes na página inicial. Esta descrição é conferência de fonte, não captura visual da aplicação em execução.

Captura actual da página inicial/menu ainda não disponível. A automação do Edge permaneceu bloqueada e não deve ser repetida ou contornada. Para ajustar o desenho visual ao ecrã real, a captura manual deve mostrar a página inicial e o menu, sem credenciais; dados pessoais podem ser ocultados. O protótipo abaixo é um esboço proposto, nunca uma captura.

Mapa proposto e correspondência com o existente

Grupo Destinos existentes a reaproveitar Limites e subdivisões futuras
Início Área inicial Contexto, atalhos permitidos e pendências apenas onde existam dados/consulta autorizada
Clientes e serviços Clientes (clients), Catálogo de serviços (services), Prestações em rascunho (service_drafts) Manter nomes que distingam rascunho de operação confirmada
Facturação Preparação documental (documents), Rascunhos de facturação (billing_drafts), Facturas de teste (service_invoices), Apresentação do rascunho (preview_model) Documentos/séries pertencem ao percurso existente de facturas de teste; não criar emissão real ou entrada independente sem suporte
Recebimentos Recebimentos simulados (service_receivables) Afectações/reconciliação mantêm-se dentro do percurso de teste existente; sem novas páginas vazias ou ligação bancária
Oficinas Oficina de teste (workshop) Ordens, tarefas e apontamentos continuam no módulo existente; equipamentos só como destino futuro se houver funcionalidade autorizada, nunca botão fictício
Custos e orçamento Custos directos de teste (direct_costs), Custos industriais de teste (industrial_costs), Orçamento versus realizado (industrial_budgets) Lotes pertencem ao módulo industrial; orçamento/comparação partilham o ecrã actual. Não dividir páginas sem necessidade confirmada
Contabilidade e fiscalidade Classificação contabilística (catalogue_accounting), Perfil fiscal do serviço (service_fiscal) Preservar validações e bloqueios fiscais; sem lançamentos
Administração Empresa (company), Unidades (units), Acessos (access) Apresentação do rascunho pode ficar aqui em vez de Facturação, mas nunca duplicada; configurações adicionais só se existentes e autorizadas

O grupo só aparece se houver pelo menos um destino permitido. Destino e acção mantêm as verificações existentes; nome/email não atribuem perfil. As designações Osmane/Samira exemplificam distribuições já concedidas, sem associação nominativa no código. Consulta não implica preparação, validação ou administração.

Esboço da página inicial — estrutura, sem dados inventados

┌────────────────────────┬─────────────────────────────────────────────┐
│ SGF TEMPO              │ Empresa seleccionada · Unidade seleccionada │
│                        │ Alterar contexto                            │
│ ● Início               ├─────────────────────────────────────────────┤
│ ▸ Clientes e serviços  │ Ambiente / avisos de ensaio e bloqueios      │
│ ▸ Facturação           ├─────────────────────────────────────────────┤
│ ▸ Recebimentos         │ Início                                      │
│ ▸ Oficinas             │ Trabalho no contexto seleccionado           │
│ ▸ Custos e orçamento   │                                             │
│ ▸ Contab. e fiscalidade│ A preparar e acompanhar  | A validar         │
│ ▸ Administração       │ Apenas acções permitidas; estados reais     │
│                        │                                             │
│ Conta actual           │ Atalhos permitidos                          │
│ Sair                   │ Clientes · Rascunhos · Consultas autorizadas │
└────────────────────────┴─────────────────────────────────────────────┘

Em destino interno, o grupo dessa página permanece aberto, com opção activa destacada por texto e marcador além da cor. Cabeçalhos expansíveis são botões de teclado com aria-expanded; destino activo usa aria-current. Abrir um grupo não altera o contexto nem concede acesso.

Para o preparador, dar prioridade a «A preparar e acompanhar», com atalhos para as operações que já pode iniciar e consulta do estado das suas propostas. Para a validadora, dar prioridade a «A validar», com ligações a versões exactas pendentes e acesso de consulta. Quem tiver ambos os tipos de poderes vê ambas as secções, sem poder validar a própria proposta. Não criar uma decisão directamente no cartão inicial: encaminhar para o percurso de revisão existente.

Pendências: ainda é necessário definir quais os módulos que fornecem consulta segura e actualizada de pendências. Não inferir contagens no cliente, consultar módulos sem autorização nem tratar erro/indisponibilidade como zero. Onde não houver fonte, mostrar apenas atalhos; não apresentar listas ou números simulados. Distinguir «Sem pendências» (consulta bem-sucedida), «Consulta indisponível» e «Escolha uma unidade». Rótulos do esboço não afirmam que haja tarefas concretas.

Ecrãs pequenos, estados e contexto

Em ecrã pequeno, menu em painel recolhível por botão «Menu», fechado por Escape, foco devolvido ao botão e destino activo identificável. Empresa/unidade e aviso relevante permanecem visíveis no cabeçalho; selectores podem abrir por «Alterar contexto». Conteúdo em coluna única, alvos de toque confortáveis e tabelas com scroll horizontal próprio, sem esconder montantes/estados ou provocar scroll de toda a página.

Estados com rótulo textual consistente: «Rascunho», «Aguarda validação», «Validado», «Recusado», «Histórico/desactualizado», «Incompleto» e «Operação bloqueada». Verde discreto para validação concluída, âmbar para pendência/incompletude, neutro para histórico e vermelho para erro; cor nunca é a única informação. Preservar cores base do SGF; melhorar espaçamento, alinhamento de montantes e leitura de tabelas. Não introduzir indicadores financeiros, saldos, receitas, margens ou gráficos fictícios.

Próxima revisão do desenho

Comparar este mapa/esboço com uma captura manual da página inicial e menu actuais. Confirmar onde fica «Apresentação do rascunho» e a primeira selecção de fontes reais de pendências. Só depois alterar a aplicação, preservando permissões, separação empresa/unidade e avisos. Nenhuma nova implementação ou validação visual é declarada por este documento.