Experience · Backend · Active

funnel backend

NestJS API that owns the public same-origin backend surface for FunnerAI, domain modules, queue orchestration, agent execution callbacks and realtime gateway integration.

• NestJS
• Prisma
• BullMQ
• Redis
• socket.io
• Stripe SDK
• @platform/contracts-agent
• @platform/observability

Spec sheet

Repository path

funnel-ia-engine/backend

Runtime

NestJS API plus socket.io gateway

Data

Prisma with PostgreSQL plus Redis

Async integration

BullMQ queues consumed by worker

Responsibilities

• Expose the same-origin /api surface for the product frontend.
• Own domain modules for users, contacts, products, categories, funnels, messages, billing and audit.
• Produce jobs for asynchronous processing and expose realtime events.
• Create agent execution requests in platform-agent-service and apply callback results to product messages.
• Bridge shared auth, shared AI and product orchestration through small platform clients.

Interfaces and contract surface

• Same-origin /api
• Same-origin /socket.io
• BullMQ job producers
• GET /api/agent/executions/:executionId
• POST /internal/agent/executions/callback

Consumers

• funnel frontend

Dependencies and external touchpoints

• platform-auth-service
• platform-agent-service
• PostgreSQL
• Redis
• Stripe
• @platform/contracts-agent

Notes

• The worker process bootstraps the same AppModule context used here.
• Agent execution status is now visible in the frontend through a query hook and status badge.

Source references

• docs/architecture-current.md
• funnel-ia-engine/backend/package.json
• funnel-ia-engine/README.md