Technical Docs

Architecture

System Overview

Architecture Diagram

Tech Stack

• Frontend: Next.js + Tailwind CSS (95+ Lighthouse score).

• Backend: FastAPI (Python) for async scalability.

• Database: PostgreSQL (AWS RDS) + Redis (caching).

• APIs:

  • Stripe (payments).

  • Cloverly (carbon metrics).

API Reference

Authentication

curl -X POST "https://api.ecovest.com/auth/login" \
  -H "Content-Type: application/json" \
  -d '{"email": "[e-mail]", "password": "••••••••"}'

Fetch Projects

curl -X GET "https://api.ecovest.com/v1/projects?category=solar&min_investment=100"

Response

{
  "data": [
    {
      "id": "solar-kenya-2024",
      "name": "Kenya Solar Farm",
      "impact_per_dollar": 0.0012,
      "risk_level": "medium"
    }
  ]
}

Metrics Methadology

CO2 Savings Formula

CO2 saved = (Energy produced in MWh) × (Local grid CO2 intensity - Project CO2 intensity)

Data Sources:

• EPA Emission Factors

• IEA Global Energy Data

Example:

• Solar Farm in Texas produces 200 MWh/year.

• Local grid: 0.8 tons CO2/MWh → Solar: 0.1 tons CO2/MWh.

• Total CO2 saved: 200 × (0.8 - 0.1) = 140 tons/year.