# tajaparadhruva/hackout_2k26 architecture

> Architecture diagram of the GitHub repository tajaparadhruva/hackout_2k26, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tajaparadhruva/hackout_2k26
- Repository: https://github.com/tajaparadhruva/hackout_2k26

## Overview

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: [`backend/src/routes/index.js`](https://github.com/tajaparadhruva/hackout_2k26/blob/main/backend/src/routes/index.js) (API route registry), [`backend/src/modules/matching`](https://github.com/tajaparadhruva/hackout_2k26/tree/main/backend/src/modules/matching) (Smart matching), [`backend/src/modules/transactions`](https://github.com/tajaparadhruva/hackout_2k26/tree/main/backend/src/modules/transactions) (Transactions), [`backend/src/app.js`](https://github.com/tajaparadhruva/hackout_2k26/blob/main/backend/src/app.js) (Express application)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_frontend["React application<br/>[App.jsx]"]
  node_role_views["Role workflows"]
  node_marketplace_view["Marketplace search"]
  node_matching_view["Matching view"]
  node_opportunity_view["Opportunity engine view"]
  node_twin_view["Carbon flow twin"]
  node_api_client["API client<br/>[axiosClient.js]"]
  node_auth_api_client["Auth API service<br/>[authService.js]"]
end

subgraph group_platform["API platform"]
  node_server["HTTP server<br/>[server.js]"]
  node_app["Express application<br/>[app.js]"]
  node_api_routes["API route registry<br/>[index.js]"]
  node_auth_routes["Auth routes<br/>[auth.routes.js]"]
  node_auth_controller["Auth controller<br/>[auth.controller.js]"]
  node_auth_service["Auth service<br/>[auth.service.js]"]
end

subgraph group_supply["Supply and trust"]
  node_supplier["Supplier profiles and listings"]
  node_buyer["Buyer requirements"]
  node_verification["Supplier verification"]
  node_trust["Supplier trust score"]
end

subgraph group_discovery["Discovery and delivery"]
  node_marketplace["Carbon marketplace"]
  node_matching["Smart matching"]
  node_logistics["Logistics estimates"]
  node_transactions["Transactions"]
end

subgraph group_impact["Impact and operations"]
  node_sustainability["Sustainability metrics"]
  node_analytics["Admin analytics"]
  node_notifications["Notifications"]
end

node_participant(("Platform participant"))

node_participant -->|"uses"| node_frontend
node_frontend -->|"renders"| node_role_views
node_participant -->|"explores listings"| node_marketplace_view
node_participant -->|"reviews matches"| node_matching_view
node_participant -->|"explores pathways"| node_opportunity_view
node_participant -->|"views carbon flow"| node_twin_view
node_auth_api_client -->|"calls"| node_api_client
node_auth_api_client -->|"requests auth endpoints"| node_auth_routes
node_server -->|"serves"| node_app
node_app -->|"mounts"| node_api_routes
node_app -->|"mounts"| node_auth_routes
node_api_routes -->|"mounts routes"| node_supplier
node_api_routes -->|"mounts routes"| node_buyer
node_api_routes -->|"mounts routes"| node_marketplace
node_api_routes -->|"mounts routes"| node_matching
node_api_routes -->|"mounts routes"| node_verification
node_api_routes -->|"mounts routes"| node_trust
node_api_routes -->|"mounts routes"| node_logistics
node_api_routes -->|"mounts routes"| node_transactions
node_api_routes -->|"mounts routes"| node_sustainability
node_api_routes -->|"mounts routes"| node_analytics
node_api_routes -->|"mounts routes"| node_notifications
node_auth_routes -->|"dispatches"| node_auth_controller
node_auth_controller -->|"calls"| node_auth_service
node_supplier -->|"submits documents"| node_verification
node_verification -->|"informs evaluation"| node_trust
node_supplier -->|"lists CO₂"| node_marketplace
node_buyer -->|"provides requirements"| node_matching
node_marketplace -->|"supplies opportunities"| node_matching
node_matching -->|"considers distance"| node_logistics
node_matching -->|"leads to requests"| node_transactions
node_transactions -->|"feeds impact metrics"| node_sustainability
node_transactions -->|"visualizes carbon journey"| node_twin_view

click node_frontend "https://github.com/tajaparadhruva/hackout_2k26/blob/main/frontend/src/App.jsx"
click node_role_views "https://github.com/tajaparadhruva/hackout_2k26/tree/main/frontend/src/features"
click node_marketplace_view "https://github.com/tajaparadhruva/hackout_2k26/blob/main/frontend/src/features/marketplace/pages/MarketplacePage.jsx"
click node_matching_view "https://github.com/tajaparadhruva/hackout_2k26/blob/main/frontend/src/features/matching-engine/pages/MatchingEnginePage.jsx"
click node_opportunity_view "https://github.com/tajaparadhruva/hackout_2k26/blob/main/frontend/src/features/opportunity-engine/pages/OpportunityEnginePage.jsx"
click node_twin_view "https://github.com/tajaparadhruva/hackout_2k26/blob/main/frontend/src/features/digital-twin/pages/DigitalTwinPage.jsx"
click node_api_client "https://github.com/tajaparadhruva/hackout_2k26/blob/main/frontend/src/services/api/axiosClient.js"
click node_auth_api_client "https://github.com/tajaparadhruva/hackout_2k26/blob/main/frontend/src/services/api/authService.js"
click node_server "https://github.com/tajaparadhruva/hackout_2k26/blob/main/backend/src/server.js"
click node_app "https://github.com/tajaparadhruva/hackout_2k26/blob/main/backend/src/app.js"
click node_api_routes "https://github.com/tajaparadhruva/hackout_2k26/blob/main/backend/src/routes/index.js"
click node_auth_routes "https://github.com/tajaparadhruva/hackout_2k26/blob/main/backend/src/modules/auth/auth.routes.js"
click node_auth_controller "https://github.com/tajaparadhruva/hackout_2k26/blob/main/backend/src/modules/auth/auth.controller.js"
click node_auth_service "https://github.com/tajaparadhruva/hackout_2k26/blob/main/backend/src/modules/auth/auth.service.js"
click node_supplier "https://github.com/tajaparadhruva/hackout_2k26/tree/main/backend/src/modules/supplier"
click node_buyer "https://github.com/tajaparadhruva/hackout_2k26/tree/main/backend/src/modules/buyer"
click node_verification "https://github.com/tajaparadhruva/hackout_2k26/tree/main/backend/src/modules/verification"
click node_trust "https://github.com/tajaparadhruva/hackout_2k26/tree/main/backend/src/modules/trust-score"
click node_marketplace "https://github.com/tajaparadhruva/hackout_2k26/tree/main/backend/src/modules/marketplace"
click node_matching "https://github.com/tajaparadhruva/hackout_2k26/tree/main/backend/src/modules/matching"
click node_logistics "https://github.com/tajaparadhruva/hackout_2k26/tree/main/backend/src/modules/logistics"
click node_transactions "https://github.com/tajaparadhruva/hackout_2k26/tree/main/backend/src/modules/transactions"
click node_sustainability "https://github.com/tajaparadhruva/hackout_2k26/tree/main/backend/src/modules/sustainability"
click node_analytics "https://github.com/tajaparadhruva/hackout_2k26/tree/main/backend/src/modules/analytics"
click node_notifications "https://github.com/tajaparadhruva/hackout_2k26/tree/main/backend/src/modules/notifications"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_frontend,node_role_views,node_marketplace_view,node_matching_view,node_opportunity_view,node_twin_view,node_api_client,node_auth_api_client toneBlue
class node_server,node_app,node_api_routes,node_auth_routes,node_auth_controller,node_auth_service toneAmber
class node_supplier,node_buyer,node_verification,node_trust toneMint
class node_marketplace,node_matching,node_logistics,node_transactions toneRose
class node_sustainability,node_analytics,node_notifications,node_participant toneIndigo
```

## Components

### User experience

- [React application](https://github.com/tajaparadhruva/hackout_2k26/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Role workflows](https://github.com/tajaparadhruva/hackout_2k26/tree/main/frontend/src/features): `frontend/src/features`
- [Marketplace search](https://github.com/tajaparadhruva/hackout_2k26/blob/main/frontend/src/features/marketplace/pages/MarketplacePage.jsx): `frontend/src/features/marketplace/pages/MarketplacePage.jsx`
- [Matching view](https://github.com/tajaparadhruva/hackout_2k26/blob/main/frontend/src/features/matching-engine/pages/MatchingEnginePage.jsx): `frontend/src/features/matching-engine/pages/MatchingEnginePage.jsx`
- [Opportunity engine view](https://github.com/tajaparadhruva/hackout_2k26/blob/main/frontend/src/features/opportunity-engine/pages/OpportunityEnginePage.jsx): `frontend/src/features/opportunity-engine/pages/OpportunityEnginePage.jsx`
- [Carbon flow twin](https://github.com/tajaparadhruva/hackout_2k26/blob/main/frontend/src/features/digital-twin/pages/DigitalTwinPage.jsx): `frontend/src/features/digital-twin/pages/DigitalTwinPage.jsx`
- [API client](https://github.com/tajaparadhruva/hackout_2k26/blob/main/frontend/src/services/api/axiosClient.js): `frontend/src/services/api/axiosClient.js`
- [Auth API service](https://github.com/tajaparadhruva/hackout_2k26/blob/main/frontend/src/services/api/authService.js): `frontend/src/services/api/authService.js`

### API platform

- [HTTP server](https://github.com/tajaparadhruva/hackout_2k26/blob/main/backend/src/server.js): `backend/src/server.js`
- [Express application](https://github.com/tajaparadhruva/hackout_2k26/blob/main/backend/src/app.js): `backend/src/app.js`
- [API route registry](https://github.com/tajaparadhruva/hackout_2k26/blob/main/backend/src/routes/index.js): `backend/src/routes/index.js`
- [Auth routes](https://github.com/tajaparadhruva/hackout_2k26/blob/main/backend/src/modules/auth/auth.routes.js): `backend/src/modules/auth/auth.routes.js`
- [Auth controller](https://github.com/tajaparadhruva/hackout_2k26/blob/main/backend/src/modules/auth/auth.controller.js): `backend/src/modules/auth/auth.controller.js`
- [Auth service](https://github.com/tajaparadhruva/hackout_2k26/blob/main/backend/src/modules/auth/auth.service.js): `backend/src/modules/auth/auth.service.js`

### Supply and trust

- [Supplier profiles and listings](https://github.com/tajaparadhruva/hackout_2k26/tree/main/backend/src/modules/supplier): `backend/src/modules/supplier`
- [Buyer requirements](https://github.com/tajaparadhruva/hackout_2k26/tree/main/backend/src/modules/buyer): `backend/src/modules/buyer`
- [Supplier verification](https://github.com/tajaparadhruva/hackout_2k26/tree/main/backend/src/modules/verification): `backend/src/modules/verification`
- [Supplier trust score](https://github.com/tajaparadhruva/hackout_2k26/tree/main/backend/src/modules/trust-score): `backend/src/modules/trust-score`

### Discovery and delivery

- [Carbon marketplace](https://github.com/tajaparadhruva/hackout_2k26/tree/main/backend/src/modules/marketplace): `backend/src/modules/marketplace`
- [Smart matching](https://github.com/tajaparadhruva/hackout_2k26/tree/main/backend/src/modules/matching): `backend/src/modules/matching`
- [Logistics estimates](https://github.com/tajaparadhruva/hackout_2k26/tree/main/backend/src/modules/logistics): `backend/src/modules/logistics`
- [Transactions](https://github.com/tajaparadhruva/hackout_2k26/tree/main/backend/src/modules/transactions): `backend/src/modules/transactions`

### Impact and operations

- [Sustainability metrics](https://github.com/tajaparadhruva/hackout_2k26/tree/main/backend/src/modules/sustainability): `backend/src/modules/sustainability`
- [Admin analytics](https://github.com/tajaparadhruva/hackout_2k26/tree/main/backend/src/modules/analytics): `backend/src/modules/analytics`
- [Notifications](https://github.com/tajaparadhruva/hackout_2k26/tree/main/backend/src/modules/notifications): `backend/src/modules/notifications`

### Other components

- **Platform participant**

## Connections

- Platform participant → React application: uses (evidence: `README.md`)
- React application → Role workflows: renders (evidence: `frontend/src/App.jsx`)
- Platform participant → Marketplace search: explores listings (evidence: `README.md`)
- Platform participant → Matching view: reviews matches (evidence: `README.md`)
- Platform participant → Opportunity engine view: explores pathways (evidence: `README.md`)
- Platform participant → Carbon flow twin: views carbon flow (evidence: `README.md`)
- Auth API service → API client: calls (evidence: `frontend/src/services/api/authService.js`)
- Auth API service → Auth routes: requests auth endpoints (evidence: `frontend/src/services/api/authService.js`)
- HTTP server → Express application: serves (evidence: `backend/src/server.js`)
- Express application → API route registry: mounts (evidence: `backend/src/app.js`)
- Express application → Auth routes: mounts (evidence: `backend/src/app.js`)
- API route registry → Supplier profiles and listings: mounts routes (evidence: `backend/src/routes/index.js`)
- API route registry → Buyer requirements: mounts routes (evidence: `backend/src/routes/index.js`)
- API route registry → Carbon marketplace: mounts routes (evidence: `backend/src/routes/index.js`)
- API route registry → Smart matching: mounts routes (evidence: `backend/src/routes/index.js`)
- API route registry → Supplier verification: mounts routes (evidence: `backend/src/routes/index.js`)
- API route registry → Supplier trust score: mounts routes (evidence: `backend/src/routes/index.js`)
- API route registry → Logistics estimates: mounts routes (evidence: `backend/src/routes/index.js`)
- API route registry → Transactions: mounts routes (evidence: `backend/src/routes/index.js`)
- API route registry → Sustainability metrics: mounts routes (evidence: `backend/src/routes/index.js`)
- API route registry → Admin analytics: mounts routes (evidence: `backend/src/routes/index.js`)
- API route registry → Notifications: mounts routes (evidence: `backend/src/routes/index.js`)
- Auth routes → Auth controller: dispatches (evidence: `backend/src/modules/auth/auth.routes.js`)
- Auth controller → Auth service: calls (evidence: `backend/src/modules/auth/auth.controller.js`)
- Supplier profiles and listings → Supplier verification: submits documents (evidence: `README.md`)
- Supplier verification → Supplier trust score: informs evaluation (evidence: `README.md`)
- Supplier profiles and listings → Carbon marketplace: lists CO₂ (evidence: `README.md`)
- Buyer requirements → Smart matching: provides requirements (evidence: `README.md`)
- Carbon marketplace → Smart matching: supplies opportunities (evidence: `README.md`)
- Smart matching → Logistics estimates: considers distance (evidence: `README.md`)
- Smart matching → Transactions: leads to requests (evidence: `README.md`)
- Transactions → Sustainability metrics: feeds impact metrics (evidence: `README.md`)
- Transactions → Carbon flow twin: visualizes carbon journey (evidence: `README.md`)
