# yashgarg2810/ecoverse-ai-based-environmental-simulation-platform architecture

> Architecture diagram of the GitHub repository yashgarg2810/ecoverse-ai-based-environmental-simulation-platform, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/yashgarg2810/ecoverse-ai-based-environmental-simulation-platform
- Repository: https://github.com/yashgarg2810/ecoverse-ai-based-environmental-simulation-platform

## Overview

EcoVerse is a multi-tenant campus sustainability platform. Users register an institution, map and manage campus assets, run environmental simulations, and complete audits that produce saved, viewable reports. The frontend separates mapping, simulation, analytics, and audit/report experiences; the backend provides authenticated APIs, deterministic calculations, AI recommendations, and persistence. The README documents GIS area calculations, print-to-PDF reports, and sustainability domains not fully visible in the sampled code. Some frontend-to-API connections are shown as unverified because sampled page excerpts do not expose those requests.

Main entry points: [`ecoverse-frontend/src/App.jsx`](https://github.com/yashgarg2810/ecoverse-ai-based-environmental-simulation-platform/blob/main/ecoverse-frontend/src/App.jsx) (App router), [`ecoverse-backend/server.js`](https://github.com/yashgarg2810/ecoverse-ai-based-environmental-simulation-platform/blob/main/ecoverse-backend/server.js) (REST server), [`ecoverse-backend/routes/audit.js`](https://github.com/yashgarg2810/ecoverse-ai-based-environmental-simulation-platform/blob/main/ecoverse-backend/routes/audit.js) (Audit API), [`ecoverse-backend/prisma/db.js`](https://github.com/yashgarg2810/ecoverse-ai-based-environmental-simulation-platform/blob/main/ecoverse-backend/prisma/db.js) (PostgreSQL via Prisma)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Campus experience"]
  node_app["App router<br/>[App.jsx]"]
  node_home["Home<br/>[Home.jsx]"]
  node_contact["Contact<br/>[Contact.jsx]"]
end

subgraph group_identity["Identity and access"]
  node_authui["Login and signup<br/>[Login.jsx]"]
  node_authstate["Session context<br/>[AuthContext.jsx]"]
  node_authapi["Auth routes<br/>[auth.js]"]
  node_authguard["JWT verification<br/>[authMiddleware.js]"]
end

subgraph group_sustainability["Sustainability modeling"]
  node_map["GIS campus map<br/>[Map.jsx]"]
  node_simulate["Impact simulation<br/>[Simulate.jsx]"]
  node_analytics["Impact analytics<br/>[Analytics.jsx]"]
  node_campusapi["Campus assets API<br/>[campus.js]"]
  node_engine["Formula and AI engine<br/>[formulaEngine.js]"]
end

subgraph group_audit["Audit and reporting"]
  node_auditform["Green audit form<br/>[GreenAuditForm.jsx]"]
  node_report["Generated report"]
  node_reports["Report dashboard<br/>[MyReports.jsx]"]
  node_auditapi["Audit API<br/>[audit.js]"]
end

subgraph group_platform["Backend platform"]
  node_contactapi["Contact API<br/>[contact.js]"]
  node_server["REST server<br/>[server.js]"]
  node_database[("PostgreSQL via Prisma<br/>[db.js]")]
end

node_user(("Campus user"))
node_groq{{"Groq AI service"}}

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_authui
node_app -->|"routes to"| node_map
node_app -->|"routes to"| node_simulate
node_app -->|"routes to"| node_analytics
node_app -->|"routes to"| node_auditform
node_app -->|"routes to"| node_report
node_app -->|"routes to"| node_reports
node_app -->|"routes to"| node_contact
node_authui -->|"uses session"| node_authstate
node_authstate -.->|"calls auth endpoints"| node_authapi
node_authapi -->|"reads and writes"| node_database
node_authapi -->|"protects session route"| node_authguard
node_map -.->|"manages campus assets"| node_campusapi
node_simulate -.->|"requests simulations"| node_server
node_analytics -.->|"requests analytics"| node_server
node_auditform -.->|"submits audit"| node_auditapi
node_reports -.->|"manages reports"| node_auditapi
node_report -.->|"loads report"| node_auditapi
node_server -->|"mounts routes"| node_campusapi
node_server -->|"mounts routes"| node_auditapi
node_server -->|"mounts routes"| node_authapi
node_server -->|"mounts routes"| node_contactapi
node_server -->|"calculates metrics"| node_engine
node_server -->|"queries data"| node_database
node_campusapi -->|"reads and writes"| node_database
node_campusapi -->|"requires token"| node_authguard
node_auditapi -->|"generates report"| node_engine
node_auditapi -->|"stores and retrieves"| node_database
node_auditapi -->|"requires token"| node_authguard
node_engine -->|"requests AI output"| node_groq
node_contactapi -->|"persists contact"| node_database

click node_app "https://github.com/yashgarg2810/ecoverse-ai-based-environmental-simulation-platform/blob/main/ecoverse-frontend/src/App.jsx"
click node_home "https://github.com/yashgarg2810/ecoverse-ai-based-environmental-simulation-platform/blob/main/ecoverse-frontend/src/pages/Home.jsx"
click node_contact "https://github.com/yashgarg2810/ecoverse-ai-based-environmental-simulation-platform/blob/main/ecoverse-frontend/src/pages/Contact.jsx"
click node_authui "https://github.com/yashgarg2810/ecoverse-ai-based-environmental-simulation-platform/blob/main/ecoverse-frontend/src/pages/Login.jsx"
click node_authstate "https://github.com/yashgarg2810/ecoverse-ai-based-environmental-simulation-platform/blob/main/ecoverse-frontend/src/context/AuthContext.jsx"
click node_authapi "https://github.com/yashgarg2810/ecoverse-ai-based-environmental-simulation-platform/blob/main/ecoverse-backend/routes/auth.js"
click node_authguard "https://github.com/yashgarg2810/ecoverse-ai-based-environmental-simulation-platform/blob/main/ecoverse-backend/middleware/authMiddleware.js"
click node_map "https://github.com/yashgarg2810/ecoverse-ai-based-environmental-simulation-platform/blob/main/ecoverse-frontend/src/pages/Map.jsx"
click node_simulate "https://github.com/yashgarg2810/ecoverse-ai-based-environmental-simulation-platform/blob/main/ecoverse-frontend/src/pages/Simulate.jsx"
click node_analytics "https://github.com/yashgarg2810/ecoverse-ai-based-environmental-simulation-platform/blob/main/ecoverse-frontend/src/pages/Analytics.jsx"
click node_campusapi "https://github.com/yashgarg2810/ecoverse-ai-based-environmental-simulation-platform/blob/main/ecoverse-backend/routes/campus.js"
click node_engine "https://github.com/yashgarg2810/ecoverse-ai-based-environmental-simulation-platform/blob/main/ecoverse-backend/formulaEngine.js"
click node_auditform "https://github.com/yashgarg2810/ecoverse-ai-based-environmental-simulation-platform/blob/main/ecoverse-frontend/src/pages/GreenAuditForm.jsx"
click node_report "https://github.com/yashgarg2810/ecoverse-ai-based-environmental-simulation-platform/blob/main/ecoverse-frontend/src/pages/GreenAuditReport.jsx"
click node_reports "https://github.com/yashgarg2810/ecoverse-ai-based-environmental-simulation-platform/blob/main/ecoverse-frontend/src/pages/MyReports.jsx"
click node_auditapi "https://github.com/yashgarg2810/ecoverse-ai-based-environmental-simulation-platform/blob/main/ecoverse-backend/routes/audit.js"
click node_contactapi "https://github.com/yashgarg2810/ecoverse-ai-based-environmental-simulation-platform/blob/main/ecoverse-backend/routes/contact.js"
click node_server "https://github.com/yashgarg2810/ecoverse-ai-based-environmental-simulation-platform/blob/main/ecoverse-backend/server.js"
click node_database "https://github.com/yashgarg2810/ecoverse-ai-based-environmental-simulation-platform/blob/main/ecoverse-backend/prisma/db.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_app,node_home,node_contact,node_user toneBlue
class node_authui,node_authstate,node_authapi,node_authguard toneAmber
class node_map,node_simulate,node_analytics,node_campusapi,node_engine toneMint
class node_auditform,node_report,node_reports,node_auditapi toneRose
class node_contactapi,node_server,node_database,node_groq toneIndigo
```

## Components

### Campus experience

- [App router](https://github.com/yashgarg2810/ecoverse-ai-based-environmental-simulation-platform/blob/main/ecoverse-frontend/src/App.jsx): `ecoverse-frontend/src/App.jsx`
- [Home](https://github.com/yashgarg2810/ecoverse-ai-based-environmental-simulation-platform/blob/main/ecoverse-frontend/src/pages/Home.jsx): `ecoverse-frontend/src/pages/Home.jsx`
- [Contact](https://github.com/yashgarg2810/ecoverse-ai-based-environmental-simulation-platform/blob/main/ecoverse-frontend/src/pages/Contact.jsx): `ecoverse-frontend/src/pages/Contact.jsx`

### Identity and access

- [Login and signup](https://github.com/yashgarg2810/ecoverse-ai-based-environmental-simulation-platform/blob/main/ecoverse-frontend/src/pages/Login.jsx): `ecoverse-frontend/src/pages/Login.jsx`
- [Session context](https://github.com/yashgarg2810/ecoverse-ai-based-environmental-simulation-platform/blob/main/ecoverse-frontend/src/context/AuthContext.jsx): `ecoverse-frontend/src/context/AuthContext.jsx`
- [Auth routes](https://github.com/yashgarg2810/ecoverse-ai-based-environmental-simulation-platform/blob/main/ecoverse-backend/routes/auth.js): `ecoverse-backend/routes/auth.js`
- [JWT verification](https://github.com/yashgarg2810/ecoverse-ai-based-environmental-simulation-platform/blob/main/ecoverse-backend/middleware/authMiddleware.js): `ecoverse-backend/middleware/authMiddleware.js`

### Sustainability modeling

- [GIS campus map](https://github.com/yashgarg2810/ecoverse-ai-based-environmental-simulation-platform/blob/main/ecoverse-frontend/src/pages/Map.jsx): `ecoverse-frontend/src/pages/Map.jsx`
- [Impact simulation](https://github.com/yashgarg2810/ecoverse-ai-based-environmental-simulation-platform/blob/main/ecoverse-frontend/src/pages/Simulate.jsx): `ecoverse-frontend/src/pages/Simulate.jsx`
- [Impact analytics](https://github.com/yashgarg2810/ecoverse-ai-based-environmental-simulation-platform/blob/main/ecoverse-frontend/src/pages/Analytics.jsx): `ecoverse-frontend/src/pages/Analytics.jsx`
- [Campus assets API](https://github.com/yashgarg2810/ecoverse-ai-based-environmental-simulation-platform/blob/main/ecoverse-backend/routes/campus.js): `ecoverse-backend/routes/campus.js`
- [Formula and AI engine](https://github.com/yashgarg2810/ecoverse-ai-based-environmental-simulation-platform/blob/main/ecoverse-backend/formulaEngine.js): `ecoverse-backend/formulaEngine.js`

### Audit and reporting

- [Green audit form](https://github.com/yashgarg2810/ecoverse-ai-based-environmental-simulation-platform/blob/main/ecoverse-frontend/src/pages/GreenAuditForm.jsx): `ecoverse-frontend/src/pages/GreenAuditForm.jsx`
- [Generated report](https://github.com/yashgarg2810/ecoverse-ai-based-environmental-simulation-platform/blob/main/ecoverse-frontend/src/pages/GreenAuditReport.jsx): `ecoverse-frontend/src/pages/GreenAuditReport.jsx`
- [Report dashboard](https://github.com/yashgarg2810/ecoverse-ai-based-environmental-simulation-platform/blob/main/ecoverse-frontend/src/pages/MyReports.jsx): `ecoverse-frontend/src/pages/MyReports.jsx`
- [Audit API](https://github.com/yashgarg2810/ecoverse-ai-based-environmental-simulation-platform/blob/main/ecoverse-backend/routes/audit.js): `ecoverse-backend/routes/audit.js`

### Backend platform

- [Contact API](https://github.com/yashgarg2810/ecoverse-ai-based-environmental-simulation-platform/blob/main/ecoverse-backend/routes/contact.js): `ecoverse-backend/routes/contact.js`
- [REST server](https://github.com/yashgarg2810/ecoverse-ai-based-environmental-simulation-platform/blob/main/ecoverse-backend/server.js): `ecoverse-backend/server.js`
- [PostgreSQL via Prisma](https://github.com/yashgarg2810/ecoverse-ai-based-environmental-simulation-platform/blob/main/ecoverse-backend/prisma/db.js): `ecoverse-backend/prisma/db.js`

### Other components

- **Campus user**
- **Groq AI service**

## Connections

- Campus user → App router: uses (evidence: `ecoverse-frontend/src/App.jsx`)
- App router → Home: routes to (evidence: `ecoverse-frontend/src/App.jsx`)
- App router → Login and signup: routes to (evidence: `ecoverse-frontend/src/App.jsx`)
- App router → GIS campus map: routes to (evidence: `ecoverse-frontend/src/App.jsx`)
- App router → Impact simulation: routes to (evidence: `ecoverse-frontend/src/App.jsx`)
- App router → Impact analytics: routes to (evidence: `ecoverse-frontend/src/App.jsx`)
- App router → Green audit form: routes to (evidence: `ecoverse-frontend/src/App.jsx`)
- App router → Generated report: routes to (evidence: `ecoverse-frontend/src/App.jsx`)
- App router → Report dashboard: routes to (evidence: `ecoverse-frontend/src/App.jsx`)
- App router → Contact: routes to (evidence: `ecoverse-frontend/src/App.jsx`)
- Login and signup → Session context: uses session (evidence: `ecoverse-frontend/src/context/AuthContext.jsx`)
- Session context → Auth routes: calls auth endpoints
- Auth routes → PostgreSQL via Prisma: reads and writes (evidence: `ecoverse-backend/routes/auth.js`)
- Auth routes → JWT verification: protects session route (evidence: `ecoverse-backend/routes/auth.js`)
- GIS campus map → Campus assets API: manages campus assets
- Impact simulation → REST server: requests simulations
- Impact analytics → REST server: requests analytics
- Green audit form → Audit API: submits audit
- Report dashboard → Audit API: manages reports
- Generated report → Audit API: loads report
- REST server → Campus assets API: mounts routes (evidence: `ecoverse-backend/server.js`)
- REST server → Audit API: mounts routes (evidence: `ecoverse-backend/server.js`)
- REST server → Auth routes: mounts routes (evidence: `ecoverse-backend/server.js`)
- REST server → Contact API: mounts routes (evidence: `ecoverse-backend/server.js`)
- REST server → Formula and AI engine: calculates metrics (evidence: `ecoverse-backend/server.js`)
- REST server → PostgreSQL via Prisma: queries data (evidence: `ecoverse-backend/server.js`)
- Campus assets API → PostgreSQL via Prisma: reads and writes (evidence: `ecoverse-backend/routes/campus.js`)
- Campus assets API → JWT verification: requires token (evidence: `ecoverse-backend/routes/campus.js`)
- Audit API → Formula and AI engine: generates report (evidence: `ecoverse-backend/routes/audit.js`)
- Audit API → PostgreSQL via Prisma: stores and retrieves (evidence: `ecoverse-backend/routes/audit.js`)
- Audit API → JWT verification: requires token (evidence: `ecoverse-backend/routes/audit.js`)
- Formula and AI engine → Groq AI service: requests AI output (evidence: `ecoverse-backend/formulaEngine.js`)
- Contact API → PostgreSQL via Prisma: persists contact (evidence: `ecoverse-backend/routes/contact.js`)
