🏥🩺 BLocate: Decentralized Health Monitoring

A decentralized health monitoring system using ESP32 IoT sensors, blockchain, and a modern dashboard. Eliminates single points of failure and enables permissionless deployment.

---

🚀 Project Overview

BLocate enables real-time monitoring of patient vitals (heart rate, temperature, GPS location) through a fully decentralized architecture:

• ✅ Real-time Monitoring (IoT sensors)
• ✅ Smart Geofencing (auto alerts)
• ✅ AI Health Interpretation (Gemini AI)
• ✅ Immutable Blockchain Verification
• ✅ Decentralized Storage (GunDB)
• ✅ Guardian Alerts
• ✅ Modern Frontend Dashboard

---

🛠️ Tech Stack

Backend:

Frontend:

---

🏗️ Architecture

No REST API required — frontend reads directly from blockchain + GunDB!

---

👤 User Flow

---

📋 5 Steps to Run the Repository

1️⃣ Install Dependencies Backend & Frontend

cd backend && npm install
cd ../frontend && npm install

2️⃣ Configure Backend Environment

cd ../backend
cp .env.example .env

# Edit the .env file with the following data:

# NODE_ID=patient-guardian-node-1
# NODE_ENV=development

# MQTT_BROKER=mqtt://localhost:1883
# MQTT_USERNAME=
# MQTT_PASSWORD=

# TON_RPC=https://eth-sepolia.g.alchemy.com/v2/YOUR_ALCHEMY_API_KEY
# TON_PRIVATE_KEY=your_wallet_private_key_here
# TON_CONTRACT_ADDRESS=0x0000000000000000000000000000000000000000

# SEPOLIA_RPC_URL=https://eth-sepolia.g.alchemy.com/v2/YOUR_ALCHEMY_API_KEY
# PRIVATE_KEY=your_wallet_private_key_here

# GEMINI_API_KEY=your_gemini_api_key_here
# GEMINI_API_URL=https://generativelanguage.googleapis.com/v1beta/models/gemini-pro:generateContent
# AI_ENABLED=true
# AI_FALLBACK_MESSAGE=AI Unavailable

3️⃣ Run MQTT Broker

# Windows
mosquitto -v
# Mac/Linux
brew install mosquitto && mosquitto -v

4️⃣ Start Backend & Frontend

# Backend
cd backend
npm start
# Frontend (new terminal)
cd frontend
npm run dev

5️⃣ Test Data & Dashboard

# Publish sample data to MQTT (new terminal):
mosquitto_pub -h localhost -t "patient/test-001/telemetry" -m '{"deviceId":"test-001","bpm":75,"temp":36.5,"gps":"14.5995,120.9842","timestamp":1700000000}'
# Buka dashboard di browser:
http://localhost:3000

---

📂 Directory Structure

Blocate/
├── backend/   # Node.js backend, smart contracts, MQTT, GunDB
├── frontend/  # Next.js dashboard
└── README.md  # Root project info

---

🤝 Contributing

Pull requests and issues are welcome! Please follow conventional commit messages and ensure code is linted before submitting.

---

👥 Developer Team – 4E

J. David Faculty of Engineering	Hakim N. Faculty of Computer Science	Bryan H. Faculty of Engineering	Laura F.S. Faculty of Engineering

---

Built for decentralized healthcare.