Referência dos serviços

Os nomes abaixo são os workloads dos overlays Kubernetes consultados. Os módulos Python usam diretórios com _, enquanto imagens e Services geralmente usam -.

Workload	Origem	Responsabilidade
landing	modules/landing	Página pública de entrada.
panel	modules/panel	Interface administrativa e do lojista.
frontend-entrypoint	modules/frontend_entrypoint	Autenticação, configuração, onboarding e backend do painel.
whatsapp-entrypoint	modules/whatsapp_entrypoint	Entrada/saída WhatsApp, callbacks e Flows.
b2b	modules/b2b_handler	Assistente de gestão do lojista.
b2c	modules/b2c_handler	Jornada de venda e checkout conversacional.
genai-wrapper	modules/genai_wrapper	Modelos, imagens, embeddings e busca semântica.
woocommerce-wrapper	modules/woocommerce_wrapper	Integração com loja, produtos, webhooks, frete e pedidos.
marketing-campaigns	modules/marketing_campaigns	Configuração e recursos analíticos de campanhas.
conversation-outcome-worker	Imagem de whatsapp-entrypoint	Consolidação de resultados de conversa em segundo plano.
flow-gateway	deploy/kubernetes/base/applications/flow-gateway.yaml	Roteamento público para interfaces, APIs, mídias e callbacks.

Persistência e tarefas de preparação

Redis, MinIO, Weaviate e PostgreSQL são serviços distintos dos agentes. db-migrate aplica as revisões do banco; minio-buckets prepara buckets. O overlay atual de HML inclui os três primeiros serviços persistentes, mas não provisiona PostgreSQL.

Contratos e rotas

Os schemas compartilhados ficam em contracts/. As rotas efetivas dependem dos routers de cada módulo e do mapeamento do gateway. Ao integrar uma API, verifique o contrato na versão utilizada, incluindo autenticação e contexto do lojista.

Não use uma lista histórica de endpoints como substituto dos routers atuais. O guia de integrações externas registra os callbacks públicos principais; o guia de operação explica rollouts e diagnóstico.