Console — API Registro de Admissões

1API ativa

FastAPI na porta local; health e cache

2Túnel / URL

Cloudflared expõe HTTPS público

3Integração

URL sincronizada com o sistema

4Gestor / Ficha

Apps Script + link /admissional_GML ao candidato

5Monitoramento

Métricas, testes e logs ao vivo

Visão geral

Painel operacional da API Registro de Admissões. Centraliza a URL pública (túnel), o vínculo com a base de dados, o link da ficha do candidato, métricas de quota e tráfego HTTP, envio de e-mail e diagnóstico completo do ambiente.

Integração com o gestor: o sistema lê automaticamente a URL da API. Não é necessário colar manualmente na interface do gestor — basta manter este console e o túnel ativos.

Use a barra superior para testar o sistema, atualizar o status ou abrir a documentação OpenAPI. A navegação lateral leva às seções detalhadas abaixo.

URLs e integração —

A URL do túnel (cloudflared) é a base pública da API. Ela é sincronizada com o sistema e consumida pelo gestor admissional.

URL base da API (túnel):

Aguardando túnel...

Link da ficha do candidato (/admissional_GML) — envie ao colaborador:

—

Ficha pública: rota /admissional_GML na mesma origem do túnel. O candidato preenche a admissão sem acessar este console. Se GET /admissional_GML falhar na URL pública, reinicie a API e use Reiniciar túnel.

Status do sistema

Indicadores consolidados da API, cache, túnel, base de dados e SMTP. Atualização automática a cada 15 segundos (ou ao clicar em Atualizar).

API

—

Cache

—

Cloudflared

—

Base de dados

—

E-mail (SMTP)

—

Métricas em tempo real Ao vivo —

Monitoramento da API HTTP e do consumo de quota de leitura da base de dados por processo. Atualização automática a cada 2 segundos (desde o último reinício da API).

Leituras no último minuto0%

Referência: ~55 leituras/min (limite típico por usuário). Acima disso aumenta risco de erro 429.

Ritmo (últimos 2 min, janelas de 5 s)

Processos que mais consomem quota

#	Processo	Leituras	429	Média ms	Última ms	Max ms

Distribuição do tráfego

Destaques

Todas as rotas

#	Rota	Chamadas	% do total	Média (ms)	Última (ms)	Min	Max

E-mail —

Envio de e-mails (ex.: solicitação de cancelamento) é feito pela API via SMTP. Configure no .env: SMTP_HOST, SMTP_USER, SMTP_PASSWORD, SMTP_FROM_EMAIL.

SMTP

—

Remetente

—

Referência API

Principais rotas REST. Documentação interativa em /docs.

Saúde e console

GET/health
GET/api/console/logs?since=0
GET/api/console/verify-public-url
POST/api/console/run-full-test

Admissões e candidato

GET/api/registro-admissoes
GET/api/candidato/{link_id}
POST/api/links
PATCH/api/candidato/{link_id}/ficha-admin
PATCH/api/candidato/{link_id}/aso

Uploads e kit

POST/api/candidato/{link_id}/aso/upload
POST/api/candidato/{link_id}/kit-assinado/upload
POST/api/candidato/{link_id}/kit-completo/upload
POST/api/kit/unir
POST/api/kit/validar-admin

Gestor, cancelamentos e e-mail

GET/api/opcoes-console
GET/api/solicitacoes-cancelamento
POST/api/relatorio-solicitacoes-cancelamento/excel
POST/api/email/testar

Testes Clique em «Testar sistema» no topo

Verifica credenciais, base de dados, rotas da API, ficha, opções do console, VT/VR, cancelamentos, logos, união de PDFs, túnel público, ficheiro de sync no Drive e SMTP. Pode levar 1–3 minutos.

Logs

Logs da API (app, base de dados, drive, e-mail). Atualização automática a cada 2,5 s.