SGF/docs/SGF_GUIAO_APRESENTACAO.md

# Guião de apresentação local do SGF

Entrada: **http://127.0.0.1:8085/sgf**. A aplicação é o SGF; não precisa do SGC ou de outra demonstração. Os sete módulos, incluindo RH autónomo, estão alinhados horizontalmente: abra o dropdown do módulo e escolha **Consultar** para chegar directamente ao exemplo, ou escolha a função de trabalho indicada. Os nomes QA identificam dados de teste. A lista anterior dos17 perfis continua em «Todos os perfis e módulos autorizados».

Dentro da aplicação, cada módulo tem o seu dropdown de funções. Escolher uma função de outro módulo muda explicitamente o contexto; continua a exigir a mesma autoridade e protege formulários não gravados/confirmações pendentes. Início e opções gerais estão separados dos módulos.

Este guião consulta os exemplos concluídos; não repita confirmações para os apresentar. Uma nova decisão exige prévia, fundamento e a função responsável. A revisão não pode ser feita pela própria pessoa que preparou.

| Etapa | Como abrir | O que mostrar |
|---|---|---|
|1. Comercial |Função Comercial — preparação; módulo Comercial; documentos emitidos |Documento de teste1000MZN, origem e PDF. Não é documento fiscal válido. |
|2. Compras |Funções anteriores de Compras; módulo Compras; percurso de Compras |REQ-2026-000003 → OC-2026-000001 → recepção → FACT-COMPRA-COMPLETA-20261104 → obrigação100MZN. Consultar documentos, revisões e histórico. |
|3. Stock |Armazém — Compras; módulo Stock; Existências e «Abrir trânsito, lotes e inventário» |Relatórios → Produtos sem movimento: escolher corte UTC e dias, consultar apenas pares com história conhecida, páginas25/100. No artigo de transferência: origem0,5UN, destino1UN, trânsito0, propriedade1,5UN. No novo artigo de lotes:1,5+2=3,5UN. Histórico de expedição, recepções0,4/0,6, preparação/activação/libertação, contagem e ajuste por outra pessoa. |
|4. Oficinas |Gestão/técnico/verificador conforme consulta; módulo Oficinas |Ordem, autorização, tarefa e apontamentos verificados. Em peças/Stock: consumo ligado à entrega já abatida e recepção da devolução não usada. Em Oficina→rascunho: geração500MZN; botão de continuação escolhe explicitamente Comercial e abre o mesmo rascunho. Não emite outra factura automaticamente. |
|5. Financeiro |Financeiro — preparação/revisão; módulo Financeiro |Recebível1000 com400/600 e reversão400, saldo400. Obrigação do fornecedor100→80→100; comprovativos e histórico. Custo directo275→295 e industrial1800→1820, residual300 separado. Em Caixa (`/finance/cash`): abertura0, classificação explícita do recebimento1000 já existente, despesa50, contagem e fecho950, histórico e recuperação de referência. Caixa QA fechada; não repetir operações. |
|6. Contabilidade |Contabilidade — preparação/revisão; módulo Contabilidade; diário integrado |27 lançamentos equilibrados no mesmo diário QA, duas correcções por pares, origens individuais, Stock145MZN e diferença de inventário10MZN. Plano pesquisável, balancete e razão por conta. Transferência interna é mudança de localização, sem despesa. Período aberto; o fecho QA já foi provado com rollback. |

Para confirmar as autorizações, use também a função de consulta: uma leitura não oferece os comandos de decisão. Erros de contexto/versão exigem reabrir e conferir, nunca escolher outra origem automaticamente. Se uma resposta se perder durante uma confirmação, mantenha a página e recupere o mesmo pedido.

Arranque da instalação existente: `scripts/abrir-sgf.ps1`. Reutiliza a porta8085 e o cluster existente; não cria base/demo, não faz migrations nem limpa cache. As provas de reinício não incluem um reinício completo do computador.

A revisão visual automática foi interrompida porque a ferramenta não conseguiu verificar com segurança o endereço do navegador. O utilizador confirmou a abertura/legibilidade do novo Stock. Conferir ainda a legibilidade e continuidade dos outros cinco módulos antes da aceitação integral para apresentação. [Resultados e limitações](SGF_SIX_MODULE_CLOSURE_20261110.md).

Actualização10/11: Comercial → Todos os documentos reúne seis famílias com filtros/páginas; Caixa e relatório de inactividade foram acrescentados na mesma8085. Ver `SGF_CASH_DELIVERY.md`, `SGF_BILLING_REGISTER_DELIVERY.md` e `SGF_STOCK_INACTIVITY_DELIVERY.md`. Estas entregas não substituem a revisão visual ou a aceitação explícita.

Cobertura fiscal/financeira: no dropdown Contabilidade escolha Financeiro QA preparação/revisão e abra Perfis fiscais do serviço. O painel distingue IVA parcial e motores/modelos/rácios ainda pendentes. As duas funções já possuíam os direitos de consulta; não há concessões por escolher a entrada. O conhecimento documental não é importado automaticamente. Ver SGF_FISCAL_COVERAGE_DELIVERY.md.

Livro/mapa interno IVA QA: Contabilidade → função Financeiro preparação/revisão → Livro e mapa interno de IVA QA, ou `/fiscal/iva`. As quatro decisões já estão conservadas; consulte histórico e descarregue o CSV revisto sem repetir operações. Base862,07/IVA137,93/total1000; dedução e imposto a pagar indeterminados. Consulta QA17 também pode ler o mapa. Não apresentar como modelo oficial ou IVA completo da empresa.

Regras fiscais QA: Contabilidade → Regras fiscais versionadas QA, ou `/fiscal/rules`. Duas versões revistas e cinco cálculos estão conservados (dois simples e três por linhas): escolha uma versão e consulte histórico/resultados sem repetir preparações. As taxas16%/17% são artificiais neste contrato; não afirmar mudança legal. Retirada não apaga a fotografia de cálculo anterior. Referências fiscais não conferidas ficam pendentes.

Conferência de extracto QA: Financeiro → Conferência de extracto QA ou `/finance/bank`. O extracto já está finalizado: abertura0, débito20/crédito20, fecho0; duas correspondências escolhidas/revistas individualmente com diários2/3, histórico e relatório. Não repetir importação/decisões. Não o apresentar como banco real ou integração bancária geral; não alterou Caixa950 nem diário27.

Indicadores QA: Financeiro → Critérios e indicadores QA ou `/finance/indicators`. Há dois critérios revistos e dois resultados conservados: Caixa950/saldo credor QA-FORNECEDOR100=9,50vezes; despesa50/entradas1000=5,00%. Consulte versão/fontes/fracção/relatório sem repetir decisões. Não é rácio geral de liquidez ou margem, critério real ou recomendação de pagamento; série/tendência anteriores ficam indeterminadas.

Cálculo por linhas/preço incluído: no mesmo ecrã Regras fiscais QA, consulte os três resultados novos e descarregue o mapa interno.400+600 sem imposto e464+696 incluídos: base1000/imposto160/total1160;100 incluído:86,21+13,79, exactos2500/29 e400/29, diferenças9/2900. Não repetir confirmações para apresentar. Uma nova simulação exige escolha explícita de regra/modalidade/data/moeda e fundamento; não emite factura nem altera dívida ou diário.

Início operacional: actualize a página8085 e escolha «Abrir início de…» na entrada ou «Início» após entrar. Mostre o percurso/evidências e escolha uma fonte para ver os registos existentes; não repetir confirmações. Na Oficina, Painel/Equipa/Relatórios permitem pesquisar cliente, equipamento ou responsável, filtrar o estado dos apontamentos e paginar25/100. Minutos apontados/verificados e registos sem verificação favorável mantêm significados próprios; abrir a ordem continua no workflow original. Ver SGF_OPERATIONAL_INFORMATION_DELIVERY.md.

Contabilidade → Análise: escolha explicitamente datas (o exercício tem movimentos em10/11/2026), consulte o balancete e abra o razão pela linha da conta. Há páginas25/100, totais do filtro completo, saldo progressivo e CSV apenas da página. Não há geração de lançamentos. Uma impressão faz nova leitura; não representa um relatório certificado. Ver SGF_ACCOUNTING_REPORTS_DELIVERY.md.

Financeiro → Posições de clientes e vencimentos: indique a referência para classificar vencimentos e consulte documento/cliente, estado, saldo reconhecido e revisão. Saldos são actuais; não são um relatório histórico na data escolhida. Pesquise, filtre e abra a posição exacta para comprovativos sem repetir operações. CSV apenas da página. Vencimento desconhecido continua indeterminado. Ver SGF_RECEIVABLE_POSITIONS_DELIVERY.md.

Stock → Artigos e revisão do catálogo: entre com Armazém — Compras para preparar e com a função de conferência técnica QA para rever. QA-CATALOGO-INTEGRADO/UN já está aprovado, sem saldo inicial; consulte ficha e duas versões sem repetir decisões. Artigos anteriores só para consulta. O histórico de correcção da designação foi provado na regressão. Ver SGF_STOCK_CATALOGUE_DELIVERY.md.

Os scripts de vários ecrãs devolviam HTML no servidor local; a entrega foi corrigida e conferida por MIME/SHA na8085. Actualize a página antes de conferir as funções. Isto não substitui a revisão visual ainda pendente; ver SGF_CLIENT_ASSET_DELIVERY.md.

## Posições de fornecedores —10/11

Na8085, função Financeiro com consulta autorizada → Posições de fornecedores: pesquisar fornecedor/documento, filtrar estado documental e navegar25/100. O saldo vem do motor original; o resumo/CSV abrange só a página e separa moedas. A obrigação reconhecida abre o documento exacto. Vencimento sem evidência permanece desconhecido. Não confirmar pagamentos para apresentar esta consulta. Ver `SGF_PAYABLE_POSITIONS_DELIVERY.md`.

## Condições de vencimento de fornecedor —10/11

Na mesma8085, escolher Financeiro → Posições de fornecedores. A factura100MZN mostra a data original desconhecida e, separadamente, a condição administrativa QA30/11/2026. Abrir «Condições de vencimento e histórico», indicar explicitamente30/11/2026 e consultar:0 dias;01/12/2026:1 dia. Histórico conserva preparação13/aprovação14 e a referência de evidência artificial. O saldo permanece100MZN. Para a apresentação, consultar o exemplo existente; não repetir preparação/aprovação ou pagamentos. Perfis de consulta não recebem botões de preparação/revisão. O recibo próprio pode ser consultado pela chave conservada privadamente. Ver `SGF_PAYABLE_DUE_DELIVERY.md`.

## Oficina — relatório por abertura e CSV

Na8085, função Oficina gestão ou técnico já autorizado → Oficinas → Relatórios. Escolher ambas as datas de abertura e pesquisar; pode combinar referência/cliente/equipamento/responsável e estado,25/100. Exportar apenas a página consultada. Identificação/apontamentos são actuais, o intervalo é da abertura das ordens no dia local; não apresentar como fecho diário, entrega ou produção histórica. A apresentação usa ordens existentes, sem criar novas. Ver `SGF_WORKSHOP_PERIOD_REPORT_DELIVERY.md`.

## Obrigações e prazos administrativos QA —10/11

Na8085, entrar numa função Contabilidade de consulta já autorizada (por exemplo QA17) e escolher «Obrigações e prazos administrativos QA». Indicar15/12/2026 e Consultar: uma obrigação ligada ao mapa IVA interno existente, responsável13 e entrega APENAS simulada, revista14. O prazo é artificial, não legal. A referência16/12/2026 mostra1dia decorrido, independentemente da entrega administrativa. Escolher o registo e abrir o histórico: quatro versões com autores/fundamentos/impactos anteriores e posteriores. O CSV exporta apenas a página. Não repetir preparação, revisão ou descarga para provar o que já está guardado; o SHA conferido permanece na evidência. Não apresentar como modelo oficial, submissão AT ou imposto pago. Ver `SGF_FISCAL_OBLIGATIONS_DELIVERY.md`.

## Antiguidade de fornecedores —10/11

Na8085, função Financeiro com consulta de fornecedores → «Mapa de antiguidade — fornecedores». Indicar15/12/2026 e pesquisar: o saldo original100MZN é classificado em1–30dias, com15dias desde a condição administrativa QA30/11. O prazo e o atraso originais continuam desconhecidos e separados. Totais e CSV só desta página; moedas e vencimento desconhecido separados. Abrir a condição/obrigação exacta permite consultar o histórico sem repetir decisões ou pagamentos. Não apresentar como dívida histórica, prazo legal ou recomendação. Ver `SGF_PAYABLE_AGING_DELIVERY.md`.

## Balanço e resultados internos parciais —11/11

Na8085, entrar na função Contabilidade de consulta QA17 e escolher «Demonstrações internas parciais QA». No histórico, abrir o Resultado interno v2 revisto já existente. Balanço: activos classificados2155 e fornecedor100MZN; resultados: rendimentos2586,21/gastos2200/subtotal386,21. Mostrar as nove contas por classificar e o capital/resultado completo indeterminados: não é resultado da empresa nem modelo legal. As19 linhas vêm dos27 lançamentos anteriores; a ligação ao razão conserva conta/datas. O botão de CSV envia o contexto e confere o SHA antes de guardar, sem recalcular o resultado. Não repetir preparação/revisão, não criar lançamentos para apresentar. Dados, chaves e CSV de prova ficam privados. Ver `SGF_FINANCIAL_STATEMENTS_DELIVERY.md`.

Oficinas → Equipamentos → **Consultar ordens deste equipamento**: escolher um registo existente, consultar identificação/ordens actuais, pesquisar/paginar e abrir a ordem exacta. **Voltar ao catálogo de equipamentos** conserva a pesquisa anterior. Equipamento sem ordens mostra zero; não é necessário criar operações para apresentar. [Detalhes](SGF_WORKSHOP_EQUIPMENT_ORDERS_DELIVERY.md).

**7. Recursos Humanos (autónomo):** na entrada `/sgf`, abra o dropdown Recursos Humanos e escolha RH consulta, preparação ou revisão. Dentro, abra Cadastro e remunerações internas QA: cadastro QA-COLABORADOR-01, regras artificiais3/4/8 e processamento2026-11 revistos, bruto10000/líquido8900/custo10400, mapa conservado e histórico. Consultar não repete seis decisões. Os perfis Financeiros não têm acesso a RH. Contratos, assiduidade e férias estão na função própria de RH; o cálculo salarial legal continua pendente. [Relatório](SGF_HUMAN_RESOURCES_DELIVERY.md).

**RH → Contratos, assiduidade e férias:** escolher QA-COLABORADOR-01 explicitamente, consultar QA-CONTRATO-01, dias09/10Nov, condição fictícia960min, pedido/gozo480 e disponível480. Em Conferência2026-11 mostrar os dois dias conhecidos e28 sem cobertura, o mapa/SHA e os históricos. Não repetir16 decisões para apresentar. O saldo conservado na condição é960; o saldo efectivo actual é480, identificado separadamente. [Detalhes](SGF_HUMAN_RESOURCES_PERSONNEL_DELIVERY.md).

Numa versão revista de RH, **Descarregar resumo legível desta versão** apresenta campos, tempos e saldos em formato de leitura. O CSV original conservado mantém botão/SHA separados. O resumo indica a fonte e não substitui o original nem representa um documento legal. [Detalhes](SGF_HUMAN_RESOURCES_READABLE_DELIVERY.md).


## Activos na mesma8085

Escolha Contabilidade — preparação, revisão ou consulta, conforme o trabalho, e abra Contabilidade → **Activos e depreciações internas QA**. Seleccione QA-ACTIVO-01 para consultar cadastro revisto, histórico e diário: custo1200, acumulado100, líquido1100. Em Planos mensais e Quotas por competência, escolha explicitamente a origem existente; não repita as confirmações do exemplo. Os dois lançamentos já estão aplicados. A nova demonstração interna parcial usa24 contas de plano/23 com movimento/29 lançamentos; o relatório anterior19/27 continua histórico e inalterado. Não apresentar taxas fiscais legais ou pagamentos deste activo.

## Facturação multilinha —11/11

Na mesma8085, Comercial → Facturação → **Documento com várias linhas QA**. Abra os rascunhos QA-MULTI-ACRESCIDO-01 e QA-MULTI-INCLUIDO-01 explicitamente para consultar as duas linhas, os totais1000+160=1160 e o PDF conservado TEST-MULTI-2026/1 e/2. Não repetir preparações/revisões/emissões. No Financeiro, as posições filtradas por TEST-MULTI-2026 mostram dois recebíveis1160, total2320, sem recebimentos e com vencimento efectivo desconhecido. Na Contabilidade, as duas origens têm lançamento no mesmo diário, agora31. A demonstração interna parcial v6 conserva resultado conhecido2286,21 e dez contas por classificar; as antigas continuam históricas. [Entrega e limitações](SGF_MULTI_LINE_INVOICE_DELIVERY.md).