SGF/docs/HOME_NAVIGATION_PROPOSAL.md

# 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

```text
┌────────────────────────┬─────────────────────────────────────────────┐
│ 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.