Platform Technical Documentation

This section provides technical documentation for the IDS-DRR platform components.

Platform Components

Component

Repository

Description

Frontend

IDS-DRR-Frontend

User-facing web application with interactive maps and dashboards

Data Management

IDS-DRR-Data-Management

Backend APIs for analytics and risk data

DataSpace Backend

DataSpaceBackend

Backend APIs for datasets, search, and publishing (optional)

QA Automation

IDS-DRR-QA-Automation

Automated testing and quality assurance

Data Pipeline

IDS-DRR-Pipeline

ETL pipelines for data ingestion and processing

Risk Models (Assam)

IDS-DRR-Assam-Risk-Model

Statistical models for flood risk scoring

Quick Start

The root docker-compose.yml orchestrates the core platform via git submodules for the Frontend and Data Management, plus PostGIS and Redis.

git clone --recurse-submodules https://github.com/CivicDataLab/IDS-DRR.git
cd IDS-DRR

cp platform/data-management/report_config.local.json platform/data-management/report_config.json

docker compose up -d --build

docker exec context_layer_Backend python manage.py makemigrations
docker exec context_layer_Backend python manage.py migrate
docker exec context_layer_Backend python manage.py import_data

The frontend will be available at http://localhost:3000 and the backend API at http://localhost:8000. No .env files are needed; all services have sensible defaults.

DataSpace Backend (optional)

The core platform provides analytics maps, risk scores, indicators, and reports. The DataSpaceBackend is a separate service that enables the datasets catalog, search, and publishing features in the Frontend.

See the DataSpaceBackend repository for setup instructions. Once running, create platform/frontend/.env.local to connect it, for example:

BACKEND_URL="http://localhost:8001"
NEXT_PUBLIC_BACKEND_URL="http://localhost:8001"

Component Documentation