How tusharthakur04/classmate works
Project type and purpose
• This is a full-stack, microservices-based automation tool (“classmate”) that lets users define flows triggered by Gmail events and execute actions (save to Drive, set reminders, call Calendar API, etc.).
• Key use cases: OAuth onboarding, polling Gmail history, publishing events to a message bus (Kafka), processing flows, and executing actions in isolated worker containers.
File structure
Top-level directories each represent a service/component, all packaged as independent Docker containers:
• frontend: Next.js React UI for flow creation and dashboard
• backend: core API (user management, flow CRUD, OAuth endpoints)
• hooks: webhook registration service that receives event posts and writes to the database
• poller: long-polls the Gmail API, fetches new messages/history, and forwards events to hooks or Kafka
• processor: subscribes to Kafka, interprets flow definitions, and emits action tasks
• worker: executes individual actions (Gmail send, Drive upload, Calendar create, reminders)
Each service uses Prisma (schema.prisma) for DB access, and they share a central relational database. processor also integrates with Kafka as a message broker.
README
• The README is minimal, so we rely on controllers, routes, utils, and Prisma schemas to infer responsibility boundaries, API endpoints, and data flows.