How srinivas-batthula/coflow works
CoFlow is a web app for hackathon teams. Members authenticate, join or manage teams, collaborate on assigned tasks and chat in real time; the client communicates with Express endpoints and Socket.IO. A separate branch discovers and serves hackathon listings, while queued push notifications and the installable offline-capable PWA extend collaboration beyond active sessions. The graph uses README workflow descriptions and SOURCE INDEX references; unsampled team and chat implementation details are represented only where documented.
Main entry points: mainScraper.js Scraper coordinator · TaskSection.js Task section · MainRouter.js API routes · authRouter.js Auth routes
Components 34
Web client
- Next.js application
frontend/app - Team views
frontend/app/teams - Task section
frontend/components/TaskSection.js - Task creation
frontend/components/CreateTask.js - Task details
frontend/components/TaskModal.js - Team chat
frontend/components/ChatSection.js - Auth state
frontend/store/useAuthStore.js - Team state
frontend/store/useTeamStore.js - Offline PWA
frontend/public/service-worker.js - Hackathon state
frontend/store/useHackathonStore.js
Identity
- Express API
backend/app.js - API routes
backend/routes/MainRouter.js - Auth routes
backend/routes/authRouter.js - Auth controller
backend/controllers/auth_controller.js - OAuth routes
backend/routes/googleOAuthRoutes.js - OAuth strategies
backend/strategies/githubStrategy.js - User records
backend/models/userModel.js
Team collaboration
- Team routes
backend/routes/teamRouter.js - Team management
backend/controllers/teams_controller.js - Team records
backend/models/TeamModel.js - Task events
frontend/components/TaskSection.js - Task socket
backend/socket/taskSocket.js - Task records
backend/models/taskModel.js - Chat messages
backend/models/chatMessageModel.js
Hackathon listings
- Hackathon endpoints
backend/controllers/hackathons_controller.js - Hackathon records
backend/models/hackathonsModel.js - Scraper coordinator
backend/services/scrapers/mainScraper.js - Devpost fetcher
backend/services/scrapers/devpostapi_fetcher.js - Unstop scraper
backend/services/scrapers/unstop_scraper.js - Browser scraper
backend/services/scrapers/browser.js - Scheduled sync
backend/services/cron_jobs/hackathonsUpdater.js
Realtime delivery
- Runtime server
backend/server.js - Socket dispatcher
backend/socket/index.js
Other components
- Team member
Connections 38
- Team member → Next.js application: uses
README.md - Next.js application → Team views: opens
README.md - Next.js application → Auth state: authenticates through
- Team views → Task section: shows tasks
- Task section → Task creation: renders
frontend/components/TaskSection.js - Task section → Task details: renders
frontend/components/TaskSection.js - Task section → Task events: emits events
frontend/components/TaskSection.js - Team member → Team chat: chats with
README.md - Team member → Auth state: signs in
frontend/store/useAuthStore.js - Auth state → Auth routes: requests auth
frontend/store/useAuthStore.js - Express API → API routes: mounts
backend/app.js - API routes → Auth routes: routes to
backend/routes/MainRouter.js - API routes → Team routes: routes to
backend/routes/MainRouter.js - API routes → Hackathon endpoints: routes to
backend/routes/MainRouter.js - Auth routes → Auth controller: dispatches
backend/routes/authRouter.js - Auth routes → OAuth routes: mounts
backend/routes/authRouter.js - OAuth routes → OAuth strategies: authenticates with
- Auth controller → User records: reads and writes
backend/controllers/auth_controller.js - Team routes → Team management: dispatches
- Team management → Team records: reads and writes
backend/controllers/teams_controller.js - Task events → Task socket: exchanges task events
README.md - Task socket → Task records: reads and writes
backend/socket/taskSocket.js - Team member → Task socket: collaborates on tasks
README.md - Team chat → Chat messages: exchanges messages
README.md - Hackathon state → Hackathon endpoints: requests listings
- Hackathon endpoints → Hackathon records: reads and writes
backend/controllers/hackathons_controller.js - Hackathon endpoints → Scraper coordinator: starts refresh
backend/controllers/hackathons_controller.js - Scheduled sync → Scraper coordinator: runs sync
backend/services/cron_jobs/hackathonsUpdater.js - Scraper coordinator → Browser scraper: uses
backend/services/scrapers/mainScraper.js - Scraper coordinator → Devpost fetcher: fetches from
backend/services/scrapers/mainScraper.js - Scraper coordinator → Unstop scraper: scrapes
backend/services/scrapers/mainScraper.js - Scraper coordinator → Hackathon records: stores listings
backend/services/scrapers/mainScraper.js - Runtime server → Express API: starts
backend/server.js - Runtime server → Scheduled sync: starts
backend/server.js - Express API → Socket dispatcher: initializes
backend/app.js - Socket dispatcher → Task socket: registers
backend/socket/index.js - Socket dispatcher → Team chat: registers chat handler
- Offline PWA → Team member: supports offline use
README.md