Simplified Flood Level Monitoring API

Full-Stack Demo for Eurac Research (RECEPTIC IoT Developer Role)
Author: Abdul Fikri | Date: March 2026
Contact: afikri@cseas.kyoto-u.ac.jp | +81 70 8905 7097

A complete IoT pipeline: ESP32-like sensor → Django REST API → PostgreSQL → Threshold Alerting → React + Leaflet Dashboard

---

Relevance to RECEPTIC Project

RECEPTIC Requirement	This Demo	My CV Experience
Django Backend	Django 5.2 LTS + DRF ViewSets	MAHS (2024–Present): Arches database management
PostgreSQL	Production-ready schema with indexes	Aceh Green (2012): Designed PostgreSQL databases for Aceh Government
REST API Design	Versioned /api/v1/ endpoints	UNICEF (2021): Interoperable mechanisms with government systems
IoT Data Ingestion	Python simulator mimicking ESP32	BNPB (2023): MHEWS SRS analysis & sensor requirements
Geospatial Visualization	React + Leaflet map dashboard	UNICEF (2021): SDG Dashboard development
System Security	CORS, server-side validation	Better Work (2018): Database security & unauthorized access prevention

---

Architecture Overview

Data Flow

1. IoT Simulator sends sensor data via HTTP POST
2. Django Backend validates and calculates alert status (server-side)
3. PostgreSQL stores readings with integrity constraints
4. React Frontend fetches data and displays interactive map
5. Django Admin provides CRUD interface for station management

---

Quick Start Guide

Prerequisites

• Python 3.10+
• PostgreSQL 15+
• Node.js 18+
• Conda (optional, for environment management)

1. Backend (Django + PostgreSQL)

# Activate environment
conda activate django_env

# Install dependencies
pip install -r requirements.txt

# Run migrations
python manage.py migrate

# Create admin user
python manage.py createsuperuser

# Start server
python manage.py runserver

2. Frontend/UI (React)

# Activate environment
cd ui
npm install
npm run dev

3. IoT Simulator

# Run python program
python simulator/send_data.py