# vignesh-2402/carbon-foot-print01 architecture

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

- Interactive diagram: https://gitdiagram.com/vignesh-2402/carbon-foot-print01
- Repository: https://github.com/vignesh-2402/carbon-foot-print01

## Overview

Carbon Footprint Awareness Platform: users authenticate, log activities, and view their emissions alongside goals, challenges, and comparisons. The React pages call an API service, which reaches Express routes; those routes own the domain operations and use MongoDB models, with activity logging also using the carbon calculator. The README documents personalized insights and data export as in progress; the tree shows a tips model but no export implementation. Edges reflect sampled calls, SOURCE INDEX references, or README statements; unsampled behavior is not inferred.

Main entry points: [`client/src/services/api.js`](https://github.com/vignesh-2402/carbon-foot-print01/blob/main/client/src/services/api.js) (API services), [`client/src/App.jsx`](https://github.com/vignesh-2402/carbon-foot-print01/blob/main/client/src/App.jsx) (App routing), [`server/server.js`](https://github.com/vignesh-2402/carbon-foot-print01/blob/main/server/server.js) (Express server), [`server/routes/activities.js`](https://github.com/vignesh-2402/carbon-foot-print01/blob/main/server/routes/activities.js) (Activity routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web application"]
  node_webapp["App routing<br/>[App.jsx]"]
  node_login["Login<br/>[LoginPage.jsx]"]
  node_register["Registration<br/>[RegisterPage.jsx]"]
  node_googlebutton["Google sign-in"]
  node_profilepage["Profile<br/>[ProfilePage.jsx]"]
  node_activitiespage["Activities<br/>[ActivitiesPage.jsx]"]
  node_activityform["Activity form<br/>[ActivityForm.jsx]"]
  node_dashboard["Dashboard<br/>[DashboardPage.jsx]"]
  node_goalspage["Goals<br/>[GoalsPage.jsx]"]
  node_challengespage["Challenges<br/>[ChallengesPage.jsx]"]
  node_api["API services<br/>[api.js]"]
end

subgraph group_identity["Identity"]
  node_authstore["Auth state<br/>[store.js]"]
  node_authroutes["Authentication routes<br/>[auth.js]"]
  node_oauthroutes["OAuth routes<br/>[oauth.js]"]
  node_authmiddleware["Token verification<br/>[auth.js]"]
  node_usermodel[("User records<br/>[User.js]")]
end

subgraph group_footprint["Footprint tracking"]
  node_activityroutes["Activity routes<br/>[activities.js]"]
  node_calculator["Carbon calculator"]
  node_activitymodel[("Activity records<br/>[Activity.js]")]
end

subgraph group_engagement["Goals and community"]
  node_goalroutes["Goal routes<br/>[goals.js]"]
  node_goalmodel[("Goal records<br/>[Goal.js]")]
  node_challengeroutes["Challenge routes<br/>[challenges.js]"]
  node_challengemodel[("Challenge records<br/>[Challenge.js]")]
  node_statsroutes["Statistics routes<br/>[stats.js]"]
  node_tipmodel[("Tip records<br/>[Tip.js]")]
end

subgraph group_platform["API and persistence"]
  node_server["Express server<br/>[server.js]"]
  node_database["MongoDB connection<br/>[database.js]"]
end

node_person(("User"))
node_mongodb[("MongoDB")]
node_google(("Google identity"))

node_person -->|"uses"| node_webapp
node_webapp -->|"routes to"| node_login
node_webapp -->|"routes to"| node_register
node_webapp -->|"routes to"| node_activitiespage
node_webapp -->|"routes to"| node_dashboard
node_webapp -->|"routes to"| node_goalspage
node_webapp -->|"routes to"| node_challengespage
node_webapp -->|"routes to"| node_profilepage
node_webapp -->|"reads"| node_authstore
node_login -->|"calls"| node_api
node_login -->|"updates"| node_authstore
node_register -->|"calls"| node_api
node_register -->|"updates"| node_authstore
node_login -->|"renders"| node_googlebutton
node_register -->|"renders"| node_googlebutton
node_googlebutton -->|"verifies token"| node_api
node_google -->|"authenticates"| node_googlebutton
node_googlebutton -->|"updates"| node_authstore
node_profilepage -->|"calls"| node_api
node_profilepage -->|"updates"| node_authstore
node_activitiespage -->|"calls"| node_api
node_activitiespage -->|"renders"| node_activityform
node_activityform -->|"calls"| node_api
node_dashboard -->|"calls"| node_api
node_goalspage -->|"calls"| node_api
node_challengespage -->|"calls"| node_api
node_api -->|"requests"| node_authroutes
node_api -->|"requests"| node_oauthroutes
node_api -->|"requests"| node_activityroutes
node_api -->|"requests"| node_goalroutes
node_api -->|"requests"| node_challengeroutes
node_api -->|"requests"| node_statsroutes
node_server -->|"mounts"| node_authroutes
node_server -->|"mounts"| node_oauthroutes
node_server -->|"mounts"| node_activityroutes
node_server -->|"mounts"| node_goalroutes
node_server -->|"mounts"| node_challengeroutes
node_server -->|"mounts"| node_statsroutes
node_authroutes -->|"protects profile"| node_authmiddleware
node_oauthroutes -->|"protects profile"| node_authmiddleware
node_authroutes -->|"reads and writes"| node_usermodel
node_oauthroutes -->|"reads and writes"| node_usermodel
node_google -->|"verifies token"| node_oauthroutes
node_activityroutes -->|"protects routes"| node_authmiddleware
node_activityroutes -->|"calculates emissions"| node_calculator
node_activityroutes -->|"reads and writes"| node_activitymodel
node_goalroutes -->|"protects routes"| node_authmiddleware
node_goalroutes -->|"reads activity data"| node_activitymodel

click node_webapp "https://github.com/vignesh-2402/carbon-foot-print01/blob/main/client/src/App.jsx"
click node_login "https://github.com/vignesh-2402/carbon-foot-print01/blob/main/client/src/pages/LoginPage.jsx"
click node_register "https://github.com/vignesh-2402/carbon-foot-print01/blob/main/client/src/pages/RegisterPage.jsx"
click node_googlebutton "https://github.com/vignesh-2402/carbon-foot-print01/blob/main/client/src/components/GoogleAuthButton.jsx"
click node_profilepage "https://github.com/vignesh-2402/carbon-foot-print01/blob/main/client/src/pages/ProfilePage.jsx"
click node_activitiespage "https://github.com/vignesh-2402/carbon-foot-print01/blob/main/client/src/pages/ActivitiesPage.jsx"
click node_activityform "https://github.com/vignesh-2402/carbon-foot-print01/blob/main/client/src/components/ActivityForm.jsx"
click node_dashboard "https://github.com/vignesh-2402/carbon-foot-print01/blob/main/client/src/pages/DashboardPage.jsx"
click node_goalspage "https://github.com/vignesh-2402/carbon-foot-print01/blob/main/client/src/pages/GoalsPage.jsx"
click node_challengespage "https://github.com/vignesh-2402/carbon-foot-print01/blob/main/client/src/pages/ChallengesPage.jsx"
click node_api "https://github.com/vignesh-2402/carbon-foot-print01/blob/main/client/src/services/api.js"
click node_authstore "https://github.com/vignesh-2402/carbon-foot-print01/blob/main/client/src/store.js"
click node_authroutes "https://github.com/vignesh-2402/carbon-foot-print01/blob/main/server/routes/auth.js"
click node_oauthroutes "https://github.com/vignesh-2402/carbon-foot-print01/blob/main/server/routes/oauth.js"
click node_authmiddleware "https://github.com/vignesh-2402/carbon-foot-print01/blob/main/server/middleware/auth.js"
click node_usermodel "https://github.com/vignesh-2402/carbon-foot-print01/blob/main/server/models/User.js"
click node_activityroutes "https://github.com/vignesh-2402/carbon-foot-print01/blob/main/server/routes/activities.js"
click node_calculator "https://github.com/vignesh-2402/carbon-foot-print01/blob/main/server/utils/carbonCalculator.js"
click node_activitymodel "https://github.com/vignesh-2402/carbon-foot-print01/blob/main/server/models/Activity.js"
click node_goalroutes "https://github.com/vignesh-2402/carbon-foot-print01/blob/main/server/routes/goals.js"
click node_goalmodel "https://github.com/vignesh-2402/carbon-foot-print01/blob/main/server/models/Goal.js"
click node_challengeroutes "https://github.com/vignesh-2402/carbon-foot-print01/blob/main/server/routes/challenges.js"
click node_challengemodel "https://github.com/vignesh-2402/carbon-foot-print01/blob/main/server/models/Challenge.js"
click node_statsroutes "https://github.com/vignesh-2402/carbon-foot-print01/blob/main/server/routes/stats.js"
click node_tipmodel "https://github.com/vignesh-2402/carbon-foot-print01/blob/main/server/models/Tip.js"
click node_server "https://github.com/vignesh-2402/carbon-foot-print01/blob/main/server/server.js"
click node_database "https://github.com/vignesh-2402/carbon-foot-print01/blob/main/server/config/database.js"

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_webapp,node_login,node_register,node_googlebutton,node_profilepage,node_activitiespage,node_activityform,node_dashboard,node_goalspage,node_challengespage,node_api,node_person toneBlue
class node_authstore,node_authroutes,node_oauthroutes,node_authmiddleware,node_usermodel,node_mongodb toneAmber
class node_activityroutes,node_calculator,node_activitymodel toneMint
class node_goalroutes,node_goalmodel,node_challengeroutes,node_challengemodel,node_statsroutes,node_tipmodel toneRose
class node_server,node_database,node_google toneIndigo
```

## Components

### Web application

- [App routing](https://github.com/vignesh-2402/carbon-foot-print01/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Login](https://github.com/vignesh-2402/carbon-foot-print01/blob/main/client/src/pages/LoginPage.jsx): `client/src/pages/LoginPage.jsx`
- [Registration](https://github.com/vignesh-2402/carbon-foot-print01/blob/main/client/src/pages/RegisterPage.jsx): `client/src/pages/RegisterPage.jsx`
- [Google sign-in](https://github.com/vignesh-2402/carbon-foot-print01/blob/main/client/src/components/GoogleAuthButton.jsx): `client/src/components/GoogleAuthButton.jsx`
- [Profile](https://github.com/vignesh-2402/carbon-foot-print01/blob/main/client/src/pages/ProfilePage.jsx): `client/src/pages/ProfilePage.jsx`
- [Activities](https://github.com/vignesh-2402/carbon-foot-print01/blob/main/client/src/pages/ActivitiesPage.jsx): `client/src/pages/ActivitiesPage.jsx`
- [Activity form](https://github.com/vignesh-2402/carbon-foot-print01/blob/main/client/src/components/ActivityForm.jsx): `client/src/components/ActivityForm.jsx`
- [Dashboard](https://github.com/vignesh-2402/carbon-foot-print01/blob/main/client/src/pages/DashboardPage.jsx): `client/src/pages/DashboardPage.jsx`
- [Goals](https://github.com/vignesh-2402/carbon-foot-print01/blob/main/client/src/pages/GoalsPage.jsx): `client/src/pages/GoalsPage.jsx`
- [Challenges](https://github.com/vignesh-2402/carbon-foot-print01/blob/main/client/src/pages/ChallengesPage.jsx): `client/src/pages/ChallengesPage.jsx`
- [API services](https://github.com/vignesh-2402/carbon-foot-print01/blob/main/client/src/services/api.js): `client/src/services/api.js`

### Identity

- [Auth state](https://github.com/vignesh-2402/carbon-foot-print01/blob/main/client/src/store.js): `client/src/store.js`
- [Authentication routes](https://github.com/vignesh-2402/carbon-foot-print01/blob/main/server/routes/auth.js): `server/routes/auth.js`
- [OAuth routes](https://github.com/vignesh-2402/carbon-foot-print01/blob/main/server/routes/oauth.js): `server/routes/oauth.js`
- [Token verification](https://github.com/vignesh-2402/carbon-foot-print01/blob/main/server/middleware/auth.js): `server/middleware/auth.js`
- [User records](https://github.com/vignesh-2402/carbon-foot-print01/blob/main/server/models/User.js): `server/models/User.js`

### Footprint tracking

- [Activity routes](https://github.com/vignesh-2402/carbon-foot-print01/blob/main/server/routes/activities.js): `server/routes/activities.js`
- [Carbon calculator](https://github.com/vignesh-2402/carbon-foot-print01/blob/main/server/utils/carbonCalculator.js): `server/utils/carbonCalculator.js`
- [Activity records](https://github.com/vignesh-2402/carbon-foot-print01/blob/main/server/models/Activity.js): `server/models/Activity.js`

### Goals and community

- [Goal routes](https://github.com/vignesh-2402/carbon-foot-print01/blob/main/server/routes/goals.js): `server/routes/goals.js`
- [Goal records](https://github.com/vignesh-2402/carbon-foot-print01/blob/main/server/models/Goal.js): `server/models/Goal.js`
- [Challenge routes](https://github.com/vignesh-2402/carbon-foot-print01/blob/main/server/routes/challenges.js): `server/routes/challenges.js`
- [Challenge records](https://github.com/vignesh-2402/carbon-foot-print01/blob/main/server/models/Challenge.js): `server/models/Challenge.js`
- [Statistics routes](https://github.com/vignesh-2402/carbon-foot-print01/blob/main/server/routes/stats.js): `server/routes/stats.js`
- [Tip records](https://github.com/vignesh-2402/carbon-foot-print01/blob/main/server/models/Tip.js): `server/models/Tip.js`

### API and persistence

- [Express server](https://github.com/vignesh-2402/carbon-foot-print01/blob/main/server/server.js): `server/server.js`
- [MongoDB connection](https://github.com/vignesh-2402/carbon-foot-print01/blob/main/server/config/database.js): `server/config/database.js`

### Other components

- **User**
- **MongoDB**
- **Google identity**

## Connections

- User → App routing: uses (evidence: `README.md`)
- App routing → Login: routes to (evidence: `client/src/App.jsx`)
- App routing → Registration: routes to (evidence: `client/src/App.jsx`)
- App routing → Activities: routes to (evidence: `client/src/App.jsx`)
- App routing → Dashboard: routes to (evidence: `client/src/App.jsx`)
- App routing → Goals: routes to (evidence: `client/src/App.jsx`)
- App routing → Challenges: routes to (evidence: `client/src/App.jsx`)
- App routing → Profile: routes to (evidence: `client/src/App.jsx`)
- App routing → Auth state: reads (evidence: `client/src/App.jsx`)
- Login → API services: calls (evidence: `client/src/pages/LoginPage.jsx`)
- Login → Auth state: updates (evidence: `client/src/pages/LoginPage.jsx`)
- Registration → API services: calls (evidence: `client/src/pages/RegisterPage.jsx`)
- Registration → Auth state: updates (evidence: `client/src/pages/RegisterPage.jsx`)
- Login → Google sign-in: renders (evidence: `client/src/pages/LoginPage.jsx`)
- Registration → Google sign-in: renders (evidence: `client/src/pages/RegisterPage.jsx`)
- Google sign-in → API services: verifies token (evidence: `client/src/components/GoogleAuthButton.jsx`)
- Google identity → Google sign-in: authenticates (evidence: `README.md`)
- Google sign-in → Auth state: updates (evidence: `client/src/pages/LoginPage.jsx`)
- Profile → API services: calls (evidence: `client/src/pages/ProfilePage.jsx`)
- Profile → Auth state: updates (evidence: `client/src/pages/ProfilePage.jsx`)
- Activities → API services: calls (evidence: `client/src/pages/ActivitiesPage.jsx`)
- Activities → Activity form: renders (evidence: `client/src/pages/ActivitiesPage.jsx`)
- Activity form → API services: calls (evidence: `client/src/components/ActivityForm.jsx`)
- Dashboard → API services: calls (evidence: `client/src/pages/DashboardPage.jsx`)
- Goals → API services: calls (evidence: `client/src/pages/GoalsPage.jsx`)
- Challenges → API services: calls (evidence: `client/src/pages/ChallengesPage.jsx`)
- API services → Authentication routes: requests (evidence: `README.md`)
- API services → OAuth routes: requests (evidence: `client/src/services/api.js`)
- API services → Activity routes: requests (evidence: `README.md`)
- API services → Goal routes: requests (evidence: `README.md`)
- API services → Challenge routes: requests (evidence: `README.md`)
- API services → Statistics routes: requests (evidence: `README.md`)
- Express server → Authentication routes: mounts (evidence: `server/server.js`)
- Express server → OAuth routes: mounts (evidence: `server/server.js`)
- Express server → Activity routes: mounts (evidence: `server/server.js`)
- Express server → Goal routes: mounts (evidence: `server/server.js`)
- Express server → Challenge routes: mounts (evidence: `server/server.js`)
- Express server → Statistics routes: mounts (evidence: `server/server.js`)
- Authentication routes → Token verification: protects profile (evidence: `server/routes/auth.js`)
- OAuth routes → Token verification: protects profile (evidence: `server/routes/oauth.js`)
- Authentication routes → User records: reads and writes (evidence: `server/routes/auth.js`)
- OAuth routes → User records: reads and writes (evidence: `server/routes/oauth.js`)
- Google identity → OAuth routes: verifies token (evidence: `server/routes/oauth.js`)
- Activity routes → Token verification: protects routes (evidence: `server/routes/activities.js`)
- Activity routes → Carbon calculator: calculates emissions (evidence: `server/routes/activities.js`)
- Activity routes → Activity records: reads and writes (evidence: `server/routes/activities.js`)
- Goal routes → Token verification: protects routes (evidence: `server/routes/goals.js`)
- Goal routes → Activity records: reads activity data (evidence: `server/routes/goals.js`)
