Skip to content

🏛 Architecture Overview

This document outlines the overall technical architecture of Darukaa.earth — our AI‑powered digital MRV platform for carbon, biodiversity, and nature‑risk insight. It helps every team member visualise how the pieces fit together across environments, from data ingestion to credit issuance.

🌐 System Components

Darukaa is composed of the following major components:

Component Description Tech Stack Repository
Marketing Website Public‑facing brand site Astro + Tailwind CSS Darukaa.earth
Web Application Main ESG & nature‑data dashboard for clients React (Vite) + TypeScript Product
Backend API Core business logic, auth, and data services FastAPI + PostgreSQL Product_backend
Credit Engine / Eco‑AI Models AI layer that converts raw signals to auditable credits & TNFD metrics Python (PyTorch) + Vertex AI Part of backend repo
Cloud Functions Event‑driven tasks (reports, email, ML batch jobs) Python (GCF) In backend repo
CI/CD Pipelines Automated build & deploy via GCP GitHub Actions + Cloud Build GitHub

🔄 Data Flow (Ingest → Analyse → Serve)

  1. Ingest — satellite, UAV imagery, bioacoustics, sensor & community data land in GCS buckets or Pub/Sub topics.
  2. Analyse — the Credit Engine runs species detection, habitat quality, carbon stock estimation, and nature‑risk scoring.
  3. Serve — results are exposed via the Backend API to the Web App, TNFD/TCFD report generator, and credit‑minting workflows.

🚀 Environments

Layer Staging Production
Web App https://staging.darukaa.com https://app.darukaa.com
API https://api.staging.darukaa.com https://api.darukaa.com
Marketing — https://www.darukaa.earth
Assets (GCS) gs://darukaa‑staging‑assets gs://darukaa‑prod‑assets
DB instance darukaa‑staging (Cloud SQL) darukaa‑prod (Cloud SQL)

Each environment has isolated services, databases, and secrets to avoid cross‑environment interference.

đŸ§© High-Level Diagram

TBD

Hosting & Infrastructure

  1. Cloud Provider: Google Cloud Platform (GCP)

  2. Static Assets: Hosted via Cloud Storage + CDN

  3. Compute: Cloud Run (API), Cloud Functions

  4. Secrets Management: GCP Secret Manager

  5. Database: Cloud SQL (PostgreSQL)

  6. Monitoring: Cloud Monitoring, Cloud Logging