How jigar-chaudhary-137/clubops-ai-by-nextbuildx works
ClubOps AI is a multi-tenant operations workspace for college clubs. Organizers use the protected React workspace to manage events, tasks, volunteers, meetings, documents, risks, and announcements through the API. AI capabilities add meeting extraction, grounded document search, risk analysis, announcement drafting, and proposed operational actions; the documented safety model requires confirmation before AI mutations. Delivery includes in-app notifications and multi-channel announcements, including WhatsApp. The graph combines documented product workflows with relationships visible in sampled source and the source index; unsampled subsystem internals are represented at their existing directories.
Main entry points: ai.service.js AI Orchestration · AppRoutes.jsx Workspace Routes · announcementDeliveryService.js Announcement Delivery · controllers AI Controllers
Components 28
Workspace UI
- Workspace Routes
client/src/routes/AppRoutes.jsx - Task Workspace
client/src/pages/tasks/TasksPage.jsx - Document Workspace
client/src/pages/documents/DocumentsPage.jsx - Session Context
client/src/context/AuthContext.jsx - API Client
client/src/services/api/client.js
Club Operations
- Operations Records
server/src/models - Operations Services
server/src/services
AI Intelligence
- Meeting Processing
server/src/ai/extraction/meetingProcessor.js - AI Orchestration
server/src/ai/services/ai.service.js - Operations Agent
server/src/ai/agents/operationsAgent.js - Knowledge Retrieval
server/src/ai/rag/ragEngine.js - Document Ingestion
server/src/ai/rag - Risk Analysis
server/src/ai/risk/riskEngine.js - Gemini Client
server/src/ai/gemini/client.js
Communication
- Announcement Delivery
server/src/services/announcements/announcementDeliveryService.js - Broadcast Tracking
server/src/services/broadcast.service.js - WhatsApp Delivery
server/src/services/whatsapp.service.js - Notifications
server/src/services/notification.service.js - SSE Connections
server/src/utils/realtime.js
API and State
- API Routes
server/src/routes - Authentication
server/src/middleware/auth.js - AI Controllers
server/src/ai/controllers - Knowledge Controller
server/src/ai/controllers/knowledge.controller.js - Announcement Controller
server/src/controllers/announcement.controller.js - WhatsApp Controller
server/src/controllers/whatsapp.controller.js - Notification Controller
server/src/controllers/notification.controller.js - API Response Helpers
server/src/utils/apiResponse.js
Other components
- Organizer
Connections 30
- Organizer → Workspace Routes: uses workspace
client/src/routes/AppRoutes.jsx - Workspace Routes → Task Workspace: routes to
client/src/routes/AppRoutes.jsx - Workspace Routes → Document Workspace: routes to
client/src/routes/AppRoutes.jsx - Workspace Routes → Session Context: loads session
client/src/App.jsx - Task Workspace → API Client: requests tasks
client/src/pages/tasks/TasksPage.jsx - API Client → API Routes: calls API
README.md - API Routes → Authentication: guards requests
server/src/routes/announcements.routes.js - API Routes → AI Controllers: routes AI
- AI Controllers → AI Orchestration: delegates AI
server/src/ai/controllers/ai.controller.js - AI Controllers → Knowledge Controller: routes knowledge
server/src/ai/routes/ai.routes.js - Knowledge Controller → Knowledge Retrieval: queries knowledge
server/src/ai/controllers/knowledge.controller.js - Document Workspace → Document Ingestion: uploads documents
README.md - AI Orchestration → Meeting Processing: extracts meeting actions
server/src/ai/services/ai.service.js - AI Orchestration → Risk Analysis: analyzes event risks
server/src/ai/services/ai.service.js - AI Orchestration → Operations Agent: runs agent
server/src/ai/services/ai.service.js - Knowledge Retrieval → Gemini Client: synthesizes answers
server/src/ai/rag/ragEngine.js - Risk Analysis → Gemini Client: requests analysis
server/src/ai/risk/riskEngine.js - Risk Analysis → Operations Records: reads operational data
server/src/ai/risk/riskEngine.js - AI Orchestration → Operations Services: applies confirmed actions
server/src/ai/services/ai.service.js - Organizer → AI Orchestration: confirms proposals
README.md - Announcement Controller → Announcement Delivery: dispatches announcement
server/src/controllers/announcement.controller.js - Announcement Delivery → Broadcast Tracking: tracks deliveries
server/src/services/announcements/announcementDeliveryService.js - Announcement Delivery → WhatsApp Delivery: sends WhatsApp
server/src/services/announcements/announcementDeliveryService.js - WhatsApp Controller → WhatsApp Delivery: updates delivery status
server/src/controllers/whatsapp.controller.js - WhatsApp Controller → Broadcast Tracking: retries delivery
server/src/controllers/whatsapp.controller.js - Notification Controller → Notifications: fetches notifications
server/src/controllers/notification.controller.js - Notification Controller → SSE Connections: opens SSE
server/src/controllers/notification.controller.js - Announcement Delivery → SSE Connections: publishes updates
server/src/services/announcements/announcementDeliveryService.js - AI Orchestration → Operations Records: reads workspace context
server/src/ai/services/ai.service.js - AI Controllers → API Response Helpers: formats responses
server/src/ai/controllers/ai.controller.js