Acompanhamento da Feature

Integração API Títulos - BMAC Method

Painel de leitura da documentação, planejamento e implementação por feature, com seleção centralizada antes da navegação.

Relatório Executivo Selecionar Feature Voltar ao Login
Planejamento
3
Stories
1 1 arquivos
Em Review
0
Prontas p/ Dev
0
Concluídas
1
Docs
27
Progresso Total da Feature
Feature `integracao-api-titulos`
1 concluídas, 0 em review, 0 prontas para dev, 0 ainda não iniciadas.
Andamento estimado
100%
Próximos Passos
BMAC Nenhum próximo passo automático identificado com o estado atual dos artefatos.
Filtros de Stories
Epics e Stories
Epic 1: Trilha de descoberta e base conceitual
Progresso estimado 100%
1 concluídas, 0 em review, 0 prontas para dev
1.1
Encerramento da trilha histórica
completed
Biblioteca de Documentos
Planning Artifacts
epics.md homologation-and-release-strategy.md implementation-plan.md
Implementation Artifacts
1-1-legado-concluido.md
Docs do Projeto
api-contracts.md architecture.md chronos-sync-local-operations.md como-abrir-uma-negociacao.md component-inventory.md data-models.md deployment-guide.md development-guide.md documentacao_api_planeta.txt fluxo-de-cobranca-30-dias.md index.md kb-governanca-e-cobertura.md manual-dashboard-cobrador.md manual-fechamento-gratificacoes.md manual-metas-premios.md perfis-e-permissoes.md politica-de-seguranca-e-backup.md project-overview.md project-scan-report.json relatorios-e-kpis.md source-tree-analysis.md travessia_campos_0002449.txt travessia_endpoints_credits_0002449_raw.txt travessia_parcelas_0002449_blocos.txt travessia_parcelas_0002449_info.txt travessia_parcelas_0002449_pretty.json travessia_parcelas_0002449_raw.json
docs/manual-fechamento-gratificacoes.md

Manual de Uso - Fechamento de Gratificações

DOCS MD
Sumário rápido
Manual de Uso - Fechamento de Gratificações Objetivo Comportamento da Central de Ajuda Objetivo da tela Fluxo de uso recomendado O que o usuário encontra na ajuda Arquivos envolvidos Publicação do artigo no HML Resultado esperado

Manual de Uso - Fechamento de Gratificações

Objetivo

Este documento descreve a funcionalidade da tela fechamento_gratificacoes.php, o comportamento da Central de Ajuda nessa página e o fluxo recomendado de uso para a equipe de gerência.

Comportamento da Central de Ajuda

Na tela de fechamento:

  • o ícone ?/informação ao lado do título agora abre a Central de Ajuda lateral
  • o painel já abre diretamente no artigo:
    • manual-fechamento-gratificacoes
  • a própria rota da página passou a ter mapeamento contextual em:
  • com isso, além da abertura direta, a tela também passa a exibir sugestão contextual na seção Sugestões para esta tela

Objetivo da tela

A tela é usada para:

  • carregar a prévia mensal de gratificação
  • revisar os valores por cobrador
  • validar composição por origem do resultado
  • conferir meta, atingido, faltante e prêmio
  • efetivar o fechamento definitivo do mês

Fluxo de uso recomendado

  1. Selecionar mês e ano.
  2. Clicar em Carregar Prévia.
  3. Conferir os indicadores superiores.
  4. Revisar a tabela por cobrador.
  5. Validar a análise automática da prévia.
  6. Somente após a conferência, clicar em Fechar Mês.

O que o usuário encontra na ajuda

O artigo publicado na Central de Ajuda explica:

  • para que serve a tela
  • quando usar
  • como carregar a prévia
  • como interpretar os indicadores
  • como validar a tabela por usuário
  • como fechar o mês
  • dúvidas comuns
  • boas práticas operacionais

Arquivos envolvidos

Publicação do artigo no HML

O artigo foi materializado por seed versionado para evitar dependência de cadastro manual no painel administrativo.

Script:

Esse script:

  • garante a categoria Relatórios
  • cria ou atualiza o artigo manual-fechamento-gratificacoes
  • publica o conteúdo com status published

Resultado esperado

Ao clicar no ícone de ajuda da tela de fechamento, o usuário deve:

  • ver a Central de Ajuda abrir no lado direito
  • encontrar imediatamente o manual da própria tela
  • conseguir continuar navegando, buscar outros artigos ou voltar à operação sem sair da página