EventFlow

EventFlow is an event-driven microservice simulator and visualizer. It lets you design microservice topologies, run in-memory simulations with failure injection, and observe real-time metrics and traces.

Stack

• Frontend: Next.js 14 (App Router), TypeScript, Tailwind CSS, React Flow, Socket.io-client, Recharts, Zustand, Shadcn UI
• Backend: Node.js, Express, TypeScript, Socket.io, BullMQ + Redis, PostgreSQL + Prisma, Helmet, CORS, Winston
• DevOps: Docker Compose (Postgres, Redis, backend, frontend)

Quick start (local)

1. Copy envs:
   • cp backend/.env.example backend/.env
   • cp frontend/.env.local.example frontend/.env.local
2. Install deps: cd backend && npm install && cd ../frontend && npm install
3. Run services: docker-compose up --build
4. Apply Prisma schema (optional outside Docker):
   • cd backend && npx prisma migrate dev --name init && npx prisma db seed

Scripts

• Backend: npm run dev, npm run build, npm run start, npm run lint
• Frontend: npm run dev, npm run build, npm run start, npm run lint

Features

• Drag-and-drop service designer with React Flow
• Real-time simulation via Socket.io
• Failure injection and dead-letter queues
• Trace viewer and metrics dashboards
• Template library (Saga, CQRS, Event Sourcing, Basic)

Testing

• (Optional) Add unit tests in backend/src/__tests__ and frontend/__tests__.

License

MIT