How tajaparadhruva/hackout_2k26 works
CarbonSphere connects captured-CO₂ suppliers with potential buyers through listings, verification, weighted matching, logistics-aware recommendations, and transactions. The frontend exposes role-based workflows and supporting views for opportunity discovery, carbon-flow visualization, sustainability, and analytics. The backend mounts domain APIs, with authentication implemented through routes, controllers, and services. The README documents the product stages and capabilities; source excerpts confirm the application wiring and authentication flow. Other domain implementations were not sampled, so their internal calls are not inferred.
Main entry points: index.js API route registry · matching Smart matching · transactions Transactions · app.js Express application
Components 26
User experience
- React application
frontend/src/App.jsx - Role workflows
frontend/src/features - Marketplace search
frontend/src/features/marketplace/pages/MarketplacePage.jsx - Matching view
frontend/src/features/matching-engine/pages/MatchingEnginePage.jsx - Opportunity engine view
frontend/src/features/opportunity-engine/pages/OpportunityEnginePage.jsx - Carbon flow twin
frontend/src/features/digital-twin/pages/DigitalTwinPage.jsx - API client
frontend/src/services/api/axiosClient.js - Auth API service
frontend/src/services/api/authService.js
API platform
- HTTP server
backend/src/server.js - Express application
backend/src/app.js - API route registry
backend/src/routes/index.js - Auth routes
backend/src/modules/auth/auth.routes.js - Auth controller
backend/src/modules/auth/auth.controller.js - Auth service
backend/src/modules/auth/auth.service.js
Supply and trust
- Supplier profiles and listings
backend/src/modules/supplier - Buyer requirements
backend/src/modules/buyer - Supplier verification
backend/src/modules/verification - Supplier trust score
backend/src/modules/trust-score
Discovery and delivery
- Carbon marketplace
backend/src/modules/marketplace - Smart matching
backend/src/modules/matching - Logistics estimates
backend/src/modules/logistics - Transactions
backend/src/modules/transactions
Impact and operations
- Sustainability metrics
backend/src/modules/sustainability - Admin analytics
backend/src/modules/analytics - Notifications
backend/src/modules/notifications
Other components
- Platform participant
Connections 33
- Platform participant → React application: uses
README.md - React application → Role workflows: renders
frontend/src/App.jsx - Platform participant → Marketplace search: explores listings
README.md - Platform participant → Matching view: reviews matches
README.md - Platform participant → Opportunity engine view: explores pathways
README.md - Platform participant → Carbon flow twin: views carbon flow
README.md - Auth API service → API client: calls
frontend/src/services/api/authService.js - Auth API service → Auth routes: requests auth endpoints
frontend/src/services/api/authService.js - HTTP server → Express application: serves
backend/src/server.js - Express application → API route registry: mounts
backend/src/app.js - Express application → Auth routes: mounts
backend/src/app.js - API route registry → Supplier profiles and listings: mounts routes
backend/src/routes/index.js - API route registry → Buyer requirements: mounts routes
backend/src/routes/index.js - API route registry → Carbon marketplace: mounts routes
backend/src/routes/index.js - API route registry → Smart matching: mounts routes
backend/src/routes/index.js - API route registry → Supplier verification: mounts routes
backend/src/routes/index.js - API route registry → Supplier trust score: mounts routes
backend/src/routes/index.js - API route registry → Logistics estimates: mounts routes
backend/src/routes/index.js - API route registry → Transactions: mounts routes
backend/src/routes/index.js - API route registry → Sustainability metrics: mounts routes
backend/src/routes/index.js - API route registry → Admin analytics: mounts routes
backend/src/routes/index.js - API route registry → Notifications: mounts routes
backend/src/routes/index.js - Auth routes → Auth controller: dispatches
backend/src/modules/auth/auth.routes.js - Auth controller → Auth service: calls
backend/src/modules/auth/auth.controller.js - Supplier profiles and listings → Supplier verification: submits documents
README.md - Supplier verification → Supplier trust score: informs evaluation
README.md - Supplier profiles and listings → Carbon marketplace: lists CO₂
README.md - Buyer requirements → Smart matching: provides requirements
README.md - Carbon marketplace → Smart matching: supplies opportunities
README.md - Smart matching → Logistics estimates: considers distance
README.md - Smart matching → Transactions: leads to requests
README.md - Transactions → Sustainability metrics: feeds impact metrics
README.md - Transactions → Carbon flow twin: visualizes carbon journey
README.md