How nikhil10510/blockbloom works
BlockBloom DAO is a web application for creating and participating in DAOs, proposals, elections, and governance, with AI assistance. Users connect a wallet in the React app; the backend provides REST APIs and real-time updates, while blockchain events are indexed into application data. The README documents local contract deployment and frontend/backend setup. The graph includes the documented governance, AI, and event-processing capabilities; several backend routes and services are represented at their exact directory paths because their implementations were not sampled.
Main entry points: App.jsx Web app routes · server.js Backend startup · aiController.js AI endpoints · eventWorker.js Event processing
Components 25
Web application
- Web app routes
frontend/src/App.jsx - Wallet authentication
frontend/src/context/AuthContext.jsx - DAO dashboard
frontend/src/pages/DAODashboard.jsx - Organizations
frontend/src/pages/Organizations.jsx - Admin dashboard
frontend/src/pages/AdminDashboard.jsx
API and governance
- REST routes
backend/src/api/routes - Authentication API
backend/src/api/controllers/authController.js - Governance API
backend/src/api/controllers - Governance services
backend/src/services - Governance records
backend/src/models - Realtime updates
backend/src/websocket/socketManager.js
AI assistance
- AI endpoints
backend/src/api/controllers/aiController.js - AI copilot
backend/src/ai/services/copilotService.js - AI agents
backend/src/ai/agents/orchestrator.js - Governance knowledge search
backend/src/ai/rag/ragPipeline.js - Chat memory
backend/src/ai/memory/memoryManager.js - Gemini integration
backend/src/ai/services/geminiService.js
Chain and events
- Backend startup
backend/src/server.js - MongoDB
backend/src/database/connection.js - Chain event indexer
backend/src/events/eventIndexer.js - Event processing
backend/src/workers/eventWorker.js - Contract access
backend/src/blockchain/contracts.js - Hardhat deployment
hardhat/deploy-local.js
Other components
- DAO participant
- Wallet and blockchain
Connections 31
- DAO participant → Web app routes: uses
frontend/src/App.jsx - Web app routes → DAO dashboard: routes to
frontend/src/App.jsx - Web app routes → Organizations: routes to
frontend/src/App.jsx - Web app routes → Admin dashboard: protects route
frontend/src/App.jsx - Web app routes → Wallet authentication: provides context
frontend/src/App.jsx - Wallet authentication → Wallet and blockchain: signs in with
frontend/src/context/AuthContext.jsx - Wallet authentication → Authentication API: requests authentication
- Web app routes → REST routes: uses API
- Backend startup → REST routes: mounts
backend/src/server.js - Backend startup → MongoDB: connects
backend/src/server.js - Backend startup → Chain event indexer: starts
backend/src/server.js - Backend startup → Event processing: starts
backend/src/server.js - Backend startup → Realtime updates: initializes
backend/src/server.js - REST routes → Governance API: routes requests
backend/src/api/routes/aiRoutes.js - REST routes → AI endpoints: routes requests
backend/src/api/routes/aiRoutes.js - AI endpoints → AI copilot: calls
backend/src/api/controllers/aiController.js - AI endpoints → AI agents: runs
backend/src/api/controllers/aiController.js - AI endpoints → Governance knowledge search: queries
backend/src/api/controllers/aiController.js - AI endpoints → Chat memory: loads history
backend/src/api/controllers/aiController.js - AI copilot → Gemini integration: generates with
backend/src/ai/services/copilotService.js - Governance knowledge search → Gemini integration: generates with
backend/src/ai/rag/ragPipeline.js - Chat memory → Governance records: persists sessions
backend/src/ai/memory/memoryManager.js - Governance API → Governance services: delegates to
- Governance services → Governance records: uses records
backend/src/services/proposalService.js - Governance services → Realtime updates: emits updates
backend/src/services/proposalService.js - Chain event indexer → Event processing: dispatches events
- Event processing → Governance records: updates records
backend/src/workers/eventWorker.js - Event processing → Realtime updates: emits events
backend/src/workers/eventWorker.js - Event processing → Contract access: reads contracts
backend/src/workers/eventWorker.js - Hardhat deployment → Wallet and blockchain: deploys contracts
README.md - Contract access → Wallet and blockchain: accesses chain