Experience · Repository · Active
funnel-ia-engine
Experience repository focused on funnels, messaging, automation, realtime product flows and agent-assisted outreach, implemented as a workspace with backend, worker and frontend.
- NestJS
- Prisma
- BullMQ
- Redis
- React 19
- Vite
- Tailwind
- TanStack Query
Spec sheet
Area
Experience / FunnerAI
Public host
http://funnel.cs.lvh.me:8080
Runtime shape
Frontend + NestJS API + Worker
Data stores
PostgreSQL plus Redis
Shared auth
Cookie session issued by platform-auth-service
Responsibilities
- Own the product experience around contacts, products, categories, funnels and messages.
- Expose realtime updates through socket.io.
- Run asynchronous jobs for messaging, enrichment and funnel-stage evaluation.
- Delegate agent execution to platform-agent-service and receive completion callbacks.
- Integrate with billing and shared AI capabilities while product-specific orchestration stays local.
Interfaces and contract surface
- Same-origin /api surface
- Same-origin /socket.io
- Frontend hash-router UI
Internal modules
Backend
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.
Worker
funnel worker
Dedicated worker process for asynchronous FunnerAI jobs, started from the backend workspace and backed by BullMQ queues on Redis.
Frontend
funnel frontend
React and Vite frontend for FunnerAI, using same-origin APIs, hash routing, TanStack Query and shared auth/http clients.
Consumers
- End users via funnel host
Dependencies and external touchpoints
Notes
- The latest agent flow records external execution ids on messages and polls execution status from the product UI.
- The canonical local bootstrap stays in platform-local-stack, not in this repo.
Source references
funnel-ia-engine/README.mddocs/architecture-current.mdfunnel-ia-engine/package.jsonfunnel-ia-engine/backend/package.jsonfunnel-ia-engine/frontend/package.json