Servicios — overview¶

Tabla canónica de los 11 Lambdas desplegados en el ambiente dev y sus responsabilidades.

Servicio	Lambda function	API GW	Trigger	Image CMD
tenant-mgmt	`zen-dev-tenant-mgmt`	`https://1zwzz5s116.execute-api.us-east-2.amazonaws.com`	HTTP API	`index.router`
auth-bff	`zen-dev-auth-bff`	`https://0pza15mlz9.execute-api.us-east-2.amazonaws.com`	HTTP API	`index.handler`
inbound-router	`zen-dev-inbound-router`	`https://eqeloz3trh.execute-api.us-east-2.amazonaws.com`	HTTP API (webhook + webchat)	`index.webhook`
inbound-router-webchat	`zen-dev-inbound-router-webchat`	(compartida con inbound-router)	HTTP API `/v1/webchat/messages`	`handlers/webchatMessages.handler`
flow-engine	`zen-dev-flow-engine`	`https://xkj1y85c7c.execute-api.us-east-2.amazonaws.com`	SQS + HTTP API (dispatcher por `eventSource`)	`handlers/dispatch.handler`
connectors-social	`zen-dev-connectors-social`	—	SQS	`index.send`
connector-orchestrator	`zen-dev-connector-orchestrator`	—	EventBridge → SQS	`index.handler`
connectors-cc	`zen-dev-connectors-cc`	—	EventBridge	`index.handler`
encuesta-service	`zen-dev-encuesta-service`	—	EventBridge	`index.handler`
outbound-dispatcher	`zen-dev-outbound-dispatcher`	`https://za9tc6il28.execute-api.us-east-2.amazonaws.com`	HTTP API + EventBridge	`index.entrypoint`
reporting-api	`zen-dev-reporting-api`	`https://flqjck4p19.execute-api.us-east-2.amazonaws.com`	HTTP API + EventBridge (projector)	`index.handler`
event-publisher	`zen-dev-event-publisher`	—	DynamoDB Streams (outbox)	`index.handler`

Responsabilidades resumidas¶

tenant-mgmt: CRUD de tenants (logical/physical), versionado optimista, evento Tenant.Updated via outbox. ADR-0011 §tenant-mgmt.
auth-bff: bff para la SPA admin contra Cognito (validación JWT + permission resolution). ADR-0005.
inbound-router: ingreso de mensajes desde proveedores (Meta, 360dialog) — verifica firmas + dedupe + publica Conversation.MessageReceived. ADR-0003.
inbound-router-webchat: handler síncrono del widget — ejecuta processInbound in-process y retorna replies en el response body. ADR-0013.
flow-engine: FSM de conversación. Lee flow de S3, ejecuta steps, persiste state en DDB, publica side-effects via EventBridge. ADR-0011 §flow-engine.
connectors-social: outbound a WhatsApp/Email/SMS (strategies whatsapp-meta-cloud, whatsapp-360dialog, email-ses, sms-sns). ADR-0007.
connector-orchestrator: resuelve la strategy correcta por canal + strategyHint, invoca connectors-social/cc. ADR-0014.
connectors-cc: handoff a contact center (five9-digital, amazon-connect). ADR-0007.
encuesta-service: ejecuta encuestas NPS post-conversación. ADR-0011 §encuesta.
outbound-dispatcher: ejecuta campañas batch (CSV uploads, scheduling). ADR-0011 §outbound.
reporting-api: lee read-models de campaigns/conversations (projector EB → DDB).
event-publisher: lee DDB Streams del outbox y publica los eventos al bus zen-dev-domain-events. ADR-0009 §outbox.

EventBridge bus: zen-dev-domain-events
DDB tables: zen-dev-tenants, zen-dev-flow-state, zen-dev-dedup, más tablas per-servicio.
S3 buckets: zen-dev-flows-450972188274 (flow catalog), zen-dev-widget-cdn-..., zen-dev-admin-cdn-..., zen-dev-auth-cdn-..., zen-dev-docs-cdn-....
KMS CMK: alias/zen-dev-platform (DDB/S3/Secrets/CloudWatch logs SSE).
Cognito: User pool us-east-2_iv0sPC5lo (zen-dev-app-users), SPA client 4mr4vrvcvklm81m8gp2mb2eb72.