Facial Global · homologacao

Servico separado desde o primeiro passo.

Este host existe para garantir uma divisao real entre a plataforma ExtremePic e o futuro modulo Facial Global. Ele roda no mesmo VPS por enquanto, mas com pasta, deploy, porta, proxy e healthcheck proprios para facilitar migracao futura sem reabrir a arquitetura.

Status atual

Bootstrap de infraestrutura pronto para evolucao

ServicoExtremePic Facial Global Service
Ambientehomolog
Versao0.1.0
Base publicahttps://global.extremepic.com.br

Principios que guiam este braco

Servico separado desde o inicio

O Facial Global nasce fora do backend principal e conversa com a plataforma apenas por API. Isso permite trocar linguagem, runtime ou banco depois sem reescrever o core do portal.

Event-scoped continua sendo o core

O reconhecimento por evento continua padrao do produto. O global entra como camada opcional, controlada e auditavel.

Processar embeddings, nao revarrer originais

O custo deve ficar concentrado em indice, fila e matching. Releitura de imagem bruta so entra quando realmente necessaria.

Governanca antes de escala

Consentimento, preview, limites operacionais, pause/resume e historico de execucoes precisam existir antes de ganhar autonomia real.

Topologia atual desta homologacao

Subdominioglobal.extremepic.com.br
Porta interna dedicada127.0.0.1:18110 -> container 8000
Modo atualHomologacao no mesmo VPS, com deploy e proxy independentes
Tipo de integracao futuraAPI-first: platform -> global service -> callbacks/resultados

Planejamento detalhado por fases

Fase 0

Bootstrap do servico

Separar runtime, subdominio, deploy e healthcheck do modulo global.

  • servico standalone em pasta propria
  • docker compose proprio no VPS
  • nginx/vhost proprio em subdominio dedicado
  • pagina inicial e endpoints de health/meta
Fase 1

Contratos de API e controle operacional

Definir como a plataforma chama o servico e como o servico devolve resultados e incidentes.

  • API para registrar consentimento do atleta
  • API para criar execucoes de preview e backfill
  • kill switch, pause/resume e limites por execucao
  • modelo de status, erros e callbacks
Fase 2

Fila de atletas e motor de escopo

Colocar atletas autorizados em fila e montar o recorte de eventos elegiveis.

  • fila por atleta consentido
  • janela por periodo, evento e prioridade comercial
  • preview com estimativa de custo e volume
  • controle de concorrencia e throttling
Fase 3

Backfill assistido e incremental

Processar eventos antigos em lotes e escutar eventos novos sem tornar o modulo sempre ativo.

  • executor de lotes historicos
  • consumo incremental de eventos novos
  • checkpoint por atleta e por evento
  • reprocessamento seletivo por incidente ou baixa confianca
Fase 4

Integracao com admin, qualidade e notificacoes

Dar visibilidade operacional e fechar o loop comercial.

  • painel admin com preview, execucoes e incidentes
  • integracao com qualidade/reclamacoes
  • historico por atleta e por execucao
  • ganchos para email e WhatsApp futuro

Sequencia imediata de execucao

1

Bootstrapar o servico e publicar o subdominio

Criar a borda independente agora, no mesmo VPS, para evitar acoplamento com o app principal depois.

2

Definir contratos da plataforma com o servico

Fechar payloads de consentimento, preview, execucao, callback, historico e incidentes antes de codar matching real.

3

Implementar o intake de consentimento

Quando o atleta autorizar, a plataforma envia o evento para a fila do Facial Global em vez de disparar processamento irrestrito.

4

Construir o preview de impacto

Antes de rodar, o servico precisa responder quantidade de eventos, fotos, embeddings, tempo estimado e custo computacional.

5

Executar backfill assistido por lotes

Priorizar por janela temporal, valor comercial e capacidade operacional, evitando global continuo sempre ligado.

6

Integrar com admin e qualidade

Exibir status, incidentes, pausas, limite por atleta, limite diario e historico auditavel no painel existente.

Frentes que entram agora

agora

Infra homologada

Subdominio, compose proprio, Nginx proprio, healthcheck e pagina inicial publicados.

proximo passo de backend

Contrato base do servico

Especificar endpoints para consentimento, preview, create-run, pause, resume, cancel e callback.

backend + dados

Modelo de execucao

Definir entidades de run, scope, queue item, estimate, budget guard e incident.

web/admin

Admin operacional

Criar tela com liga/desliga, pause/resume, preview de impacto, historico e erros.

backend principal

Integracao com plataforma

Enviar consentimento e receber resultados sem acoplar banco nem fila interna ao servico novo.