TP_VALIDACAOMPD055 - Tipo de Validação na Entrada do Clube (MPD055)

Tela de configuração: ADM012 — Parâmetros do Usuário Campo na tela: "Entrada Clube" (combobox) Tabela: PARMUSUARIO.TP_VALIDACAOMPD055 Valor padrão no banco: E (Portaria) Valor padrão ao incluir novo usuário (ADM012): N (Nenhum)

Telas impactadas

Tela	Módulo	Efeito
MPD055	Pedidos	Principal consumidora. Define o modo de operação da tela de Entrada do Clube (Portaria / Academia / Piscina).
RPD034	Relatórios	Filtro disponível para filtrar tipo de validação do usuário no relatório.
ADM013	Administração	Copia o valor ao duplicar um usuário.
OFI001	Oficina	Mantém o campo em PARMUSUARIO; ao inserir novo registro, atribui 'E'.

Campos envolvidos

Campo	Tabela	Descrição
TP_VALIDACAOMPD055	PARMUSUARIO	Tipo de validação do usuário na tela MPD055
CD_USUARIO	PARMUSUARIO	Código do usuário (chave parcial)
CD_EMPRESA	PARMUSUARIO	Código da empresa (chave parcial)
TP_CHECKIN	PESSOAATIVIDADE	Grava o mesmo valor de TP_VALIDACAOMPD055 ao registrar o check-in
ST_ATIVO	AUTORIZADOR	Verificado junto com o tipo para liberar/bloquear campos
NR_ACESSOLIMITE	PARMFATUR	Limite de acessos do clube (configurado em MFA001 — Parâmetros de Faturamento)

Opções disponíveis

E - Portaria

O que faz	Detalhe
Modo completo de portaria	Exibe grid de dependentes e parcelas financeiras
Valida inadimplência	Verifica contas vencidas e limite de acessos do sócio
Mostra vencimentos	Exibe datas de vencimento da academia e piscina do sócio
Sem catraca	Não conecta a equipamento de catraca

Simulação passo a passo

1. Acesse ADM012 e selecione o usuário desejado.
2. No campo Entrada Clube, escolha Portaria.
3. Salve o registro (<F9>).
4. Abra a tela MPD055 com esse usuário.
5. Digite o código de um sócio no campo de pesquisa.
6. Observe que o grid de dependentes e o grid de parcelas financeiras são exibidos.
7. O sistema verifica contas vencidas e compara com NR_ACESSOLIMITE (PARMFATUR). Se o sócio possuir pendências, o rótulo "Inadimplente" (vermelho) é exibido; caso contrário, "Autorizado" (verde).
8. Ao concluir o check-in, o registro em PESSOAATIVIDADE recebe TP_CHECKIN = 'E'.

Resultado esperado: A tela MPD055 funciona como portaria completa — exibe dependentes, contas financeiras, status de inadimplência e vencimentos de academia/piscina.

Exceção / Importante: Quando o usuário é do tipo Portaria (E), o campo de pesquisa de pessoa fica sempre liberado para edição, independentemente do usuário ser autorizador ou não. Para os tipos A e P, somente usuários com ST_ATIVO = 'S' na tabela AUTORIZADOR podem editar o campo de pesquisa (ver ST_AUTORIZADOR em TFA008 — Autorizador).

---

A - Academia

O que faz	Detalhe
Modo academia / sauna	Oculta dependentes e convidados; ajusta layout para foto e avaliação
Conecta à catraca	Inicializa comunicação TCP com equipamento número 0005
Valida avaliação	Verifica se a data de avaliação física (DT_AVALIACAOACADEMIA) está vencida ou prevista para hoje
Sem parcelas	Grid de parcelas financeiras não é exibido

Simulação passo a passo

1. Acesse ADM012 e selecione o usuário desejado.
2. No campo Entrada Clube, escolha Academia.
3. Salve o registro (<F9>).
4. Abra a tela MPD055 com esse usuário.
5. O sistema conecta automaticamente à catraca (equipamento 0005).
6. Digite o código de um sócio no campo de pesquisa.
7. O grid de dependentes fica oculto; o layout é ajustado para exibir a foto do sócio e informações de avaliação.
8. Se o sócio possuir avaliação física vencida, o sistema exibe alerta: "O Sócio Informado possui Avaliações previstas para o dia dd/mm/aaaa pendentes."
9. Se a avaliação vence hoje, exime: "O Sócio Informado possui Avaliações previstas para hoje."
10. Se o sócio não possui avaliação cadastrada, o check-in prossegue normalmente.
11. Ao concluir o check-in, PESSOAATIVIDADE.TP_CHECKIN recebe 'A'.

Resultado esperado: A tela MPD055 opera no modo academia — conecta à catraca, valida avaliação física do sócio e registra a entrada como tipo Academia.

Exceção / Importante: Ao fechar a tela MPD055, o sistema desconecta automaticamente da catraca. Se o usuário não for autorizador (ST_ATIVO <> 'S' em AUTORIZADOR), o campo de pesquisa de pessoa fica bloqueado para edição.

---

P - Piscina

O que faz	Detalhe
Modo piscina	Oculta dependentes e convidados; ajusta layout para foto e exame médico
Conecta à catraca	Inicializa comunicação TCP com equipamento número 0002
Valida exame médico	Verifica se o exame médico de piscina (DT_EXAMEPISCINA) está vencido ou previsto para hoje
Sem parcelas	Grid de parcelas financeiras não é exibido

Simulação passo a passo

1. Acesse ADM012 e selecione o usuário desejado.
2. No campo Entrada Clube, escolha Piscina.
3. Salve o registro (<F9>).
4. Abra a tela MPD055 com esse usuário.
5. O sistema conecta automaticamente à catraca (equipamento 0002).
6. Digite o código de um sócio no campo de pesquisa.
7. O grid de dependentes fica oculto; o layout é ajustado para exibir a foto do sócio e informações do exame médico.
8. Se o sócio não possui exame médico cadastrado, o sistema exibe alerta: "O Sócio Informado Não possui Exame Médico! Verifique!" e o check-in prossegue com alerta.
9. Se o exame médico está vencido, exibe: "O Sócio Informado possui Exame Médico com prazo vencido para o dia dd/mm/aaaa."
10. Se o exame vence hoje, exibe: "O Sócio Informado possui Exame Médico previsto para hoje."
11. Ao concluir o check-in, PESSOAATIVIDADE.TP_CHECKIN recebe 'P'.

Resultado esperado: A tela MPD055 opera no modo piscina — conecta à catraca, valida exame médico do sócio e registra a entrada como tipo Piscina.

Exceção / Importante: Ao fechar a tela MPD055, o sistema finaliza a comunicação TCP com a catraca. Se o usuário não for autorizador (ST_ATIVO <> 'S' em AUTORIZADOR), o campo de pesquisa de pessoa fica bloqueado para edição.

---

N - Nenhum

O que faz	Detalhe
Bloqueia acesso à tela	Exibe mensagem de erro e desabilita toda a interface da MPD055

Simulação passo a passo

1. Acesse ADM012 e selecione o usuário desejado.
2. No campo Entrada Clube, escolha Nenhum.
3. Salve o registro (<F9>).
4. Abra a tela MPD055 com esse usuário.
5. O sistema exibe imediatamente a mensagem: "Tipo de Usuário não Parametrizado. Verifique! [ADM012]".
6. A barra de ferramentas, os botões de sócio, digital e check-in são desabilitados. A tela fica inoperante.

Resultado esperado: O usuário não consegue operar a tela MPD055 de nenhuma forma.

---

Regra Geral de Autorização

• Usuários com tipo Portaria (E) sempre podem pesquisar sócios, independentemente de serem autorizadores.
• Para os tipos Academia (A) e Piscina (P), o campo de pesquisa de pessoa só fica liberado se o usuário também estiver ativo como autorizador (ST_ATIVO = 'S' em AUTORIZADOR).
• Quando o sócio está inadimplente e o limite de acessos foi atingido (modo Portaria), o sistema exige senha de autorização para prosseguir com o check-in.

Tabela Comparativa Resumida

Opção	Label	Dependentes	Parcelas/Contas	Catraca	Validação	TP_CHECKIN
E	Portaria	✓	✓	—	Inadimplência + limite de acessos	E
A	Academia	—	—	Equip. 0005	Avaliação física (vencida/prevista)	A
P	Piscina	—	—	Equip. 0002	Exame médico piscina (vencido/previsto)	P
N	Nenhum	—	—	—	Bloqueia acesso totalmente	—

Procedures impactadas

Rotinas Delphi com referência direta ao campo

Rotina	Arquivo	Descrição
TdmADM012.tabPARMUSUARIOAfterInsert	UdmADM012.pas:251	Atribui valor padrão 'N' ao incluir novo usuário no ADM012
TdmOFI001.tabPARMUSUARIOAfterInsert	UdmOFI001.pas:436	Atribui valor padrão 'E' ao incluir novo usuário no OFI001
TfrmADM013.btnDuplicaUsuarioClick	UADM013.pas:473	Copia TP_VALIDACAOMPD055 ao duplicar usuário
iniciar (MPD055)	UMPD055.pas:154	Lê o parâmetro para definir o modo de operação da tela de entrada
TfrmMPD055.edtCD_PESSOAExit	UMPD055.pas:910+	Usa o tipo para definir consulta de dependentes e validação financeira
TfrmMPD055.FormClose	UMPD055.pas:413	Desconecta catraca ao fechar (tipos A e P)
TfrmMPD055.btnConcluirCheckInClick	UMPD055.pas:527	Grava TP_CHECKIN em PESSOAATIVIDADE com o mesmo valor
TAtividades.btnConfirmarClick	UAtividades.pas:139	Grava TP_CHEKIN em PESSOAATIVIDADE com o mesmo valor

SQL — referência direta ao campo

Não foi encontrada referência direta ao campo TP_VALIDACAOMPD055 em procedures/views SQL (Scripts/). O consumo do parâmetro ocorre exclusivamente via código Delphi (consulta ad-hoc em UMPD055.pas).

Observações

• O valor padrão no banco de dados (DEFAULT 'E') difere do padrão atribuído no ADM012 ('N'). Ao criar um usuário pela tela ADM012, o valor será 'N' (Nenhum), exigindo configuração manual para liberar o acesso ao MPD055.
• O relatório RPD034 oferece o mesmo combobox (Portaria/Academia/Piscina) como filtro, sem a opção "Nenhum".