# Relatorio para homologacao no VPS

Destino do commit:

- Homologacao

## Objetivo

Publicar em ambiente de homologacao a nova action `consultaAcessoApp` do `gpros_hub_api`, permitindo que o SaaS consulte por `ds_cpf` se o colaborador ja fez o cadastro/primeiro acesso no App Ponto e qual e o status atual.

## Escopo desta entrega

Esta entrega adiciona apenas:

- action `consultaAcessoApp`
- registro da action no roteador `work/action.php`
- mapeamento textual dos status no `core/helpers.php`

Nao faz parte desta entrega:

- migration de banco
- alteracao de schema
- paginacao
- uso de `colaborador_pk`
- alteracoes na `main`

## Branch para homologacao

- `feature/consulta-acesso-app-status`

## Comportamento esperado

Consulta:

- chave de busca: `ds_cpf`

Retornos:

- `Liberado`
- `Aguardando liberação`
- `Acesso cancelado`
- sucesso com `registros: []` quando nao houver cadastro no app

## Arquivos alterados

- `actions/consulta_acesso_app.php`
- `core/helpers.php`
- `work/action.php`

## Procedimento no VPS

1. Nao atualizar a `main`.
2. Baixar a branch `feature/consulta-acesso-app-status`.
3. Publicar esta branch apenas em ambiente de homologacao.
4. Reiniciar a aplicacao conforme o modo atual de deploy do VPS.
5. Validar o endpoint apos a publicacao.

## Exemplo de chamada

```bash
curl -X POST "https://webservice.gepros6.com.br/work/action.php?action=consultaAcessoApp" \
  -H "Content-Type: application/json" \
  -d '{"ds_link":"https://app.cliente.com.br","ds_cpf":"460.127.358-71"}'
```

## Resultado esperado

- a action nao pode responder `Action 'consultaAcessoApp' não reconhecida`
- deve retornar JSON valido
- quando existir registro, deve retornar `success: true`, `count >= 1` e status textual
- quando nao existir cadastro, deve retornar `success: true`, `count: 0` e `registros: []`

## Validacao final a informar

Ao final da homologacao, informar:

- branch publicada
- commit publicado
- metodo de restart
- JSON retornado no teste da action