Skip to content

README.md

Latest commit

 

History

History
359 lines (275 loc) · 9.78 KB

README.md

File metadata and controls

359 lines (275 loc) · 9.78 KB
Raw

National AI-Optimized Disaster Platform for Sri Lanka

🏆 1st Runner-up at CodeFest Revivation Hackathon

A comprehensive disaster response platform built for the hackathon addressing Sri Lanka's critical disaster management challenges through AI-powered mobile and web applications.

Project Overview

The National Disaster Response Platform is a dual-platform solution consisting of:

  • Mobile App: Citizen-facing React Native application for emergency reporting and real-time alerts
  • Web Dashboard: Government administrative interface for disaster management and resource allocation

Problem Statement

Sri Lanka faces critical gaps in disaster response:

  • ❌ Outdated communication systems
  • ❌ Resource allocation bottlenecks
  • ❌ Slow government notifications
  • ❌ Lack of citizen agency in reporting
  • ❌ Fragmented data across systems

Solution Features

Mobile App (Citizen Interface)

  • 🔐 SLUDI Authentication: Secure login using Sri Lanka's Digital Public Infrastructure
  • 📍 Real-time Location Services: GPS-based emergency reporting
  • 🚨 One-tap SOS: Emergency signal with automatic location capture
  • 📝 Incident Reporting: Food, shelter, medical, and danger reports with photo upload
  • 🤖 AI Safety Assistant: Contextual chatbot for safety guidance
  • 🗺️ Risk Map: Color-coded disaster zones with real-time updates
  • 📊 Dashboard: Weather, risk assessment, and recent alerts

Web Dashboard (Government Interface)

  • 👥 Role-based Access: SLUDI authentication for government officials
  • 📈 Analytics Dashboard: Overview statistics and real-time monitoring
  • 🚨 SOS Monitor: Live emergency signal tracking with priority sorting
  • 🗺️ Reports Heatmap: Geographic visualization of citizen needs
  • 📦 Resource Management: AI-powered supply allocation and tracking
  • ⚡ Real-time Updates: WebSocket connections for live data

Technology Stack

Frontend

  • Mobile App: React Native with offline-first design
  • Web Dashboard: React with responsive design
  • Maps: React Native Maps / Google Maps API
  • State Management: React Context API

Backend

  • API Gateway: Express.js with middleware
  • Database: MongoDB Atlas with geospatial indexing
  • Authentication: SLUDI mock implementation
  • Real-time: WebSocket connections
  • AI Integration: Dialogflow/Rasa for chatbot

Data Integration

  • NDX: Mock JSON APIs for disaster data
  • SLUDI: OAuth2 mock for authentication
  • PayDPI: Optional payment simulation

##  Quick Start

### Prerequisites
- Node.js (v16 or higher)
- MongoDB Atlas account
- React Native development environment
- Android Studio / Xcode (for mobile development)

### Backend Setup

1. **Clone the repository**
   ```bash
   git clone https://github.com/disaster-response-sl/national-disaster-platform.git
   cd national-disaster-platform

  1. Install backend dependencies

    cd src/web-dashboard/backend
npm install

  2. Environment Configuration Create a .env file in src/web-dashboard/backend/:

    PORT=5000
MONGO_URI=mongodb+srv://your-username:your-password@your-cluster.mongodb.net/disaster_platform
JWT_SECRET=your-jwt-secret-key
JWT_EXPIRES_IN=24h
SLUDI_MOCK_ENABLED=true
SLUDI_BASE_URL=http://localhost:5000/mock-sludi
//.env full file provided in documentaion not provided here due to security reasons.

  3. Start the backend server

    npm start

Mobile App Setup

  1. Install mobile app dependencies

    cd src/MobileApp
npm install

  2. Install React Native dependencies

    npx react-native install

  3. Start Metro bundler

    npx react-native start

  4. Run on Android/iOS

    # Android
npx react-native run-android

# iOS
npx react-native run-ios

Web Dashboard Setup

  1. Install web dashboard dependencies

    cd src/web-dashboard/frontend
npm install

  2. Start the development server

    npm start

Testing

Test Credentials

  • Citizen Login: citizen001 / 123456
  • Responder Login: responder001 / 123456
  • Admin Login: admin001 / 123456

API Endpoints

Authentication

  • POST /api/mobile/login - User authentication
  • POST /api/mobile/register - User registration

Disasters

  • GET /api/mobile/disasters - Get active disasters
  • POST /api/mobile/disasters - Create new disaster

SOS Signals

  • GET /api/mobile/sos-signals - Get recent SOS signals
  • POST /api/mobile/sos - Send SOS signal

Reports

  • GET /api/mobile/reports - Get recent reports
  • POST /api/mobile/reports - Submit new report

Resources

  • GET /api/mobile/resources - Get available resources
  • POST /api/mobile/resources - Add new resource

Chat

  • GET /api/mobile/chat-logs - Get chat history
  • POST /api/mobile/chat - Send chat message

Team

Development Team

  • Shalon - Software Architect & Lead Software engineer
  • Gaindu - Mobile App & Web Dashboard Development
  • Lehan - Web Dashboard Development
  • Pavith - Web Dashboard Development

Roles & Responsibilities

  • Shalon: Technical architecture, Mobile app development, React Native, Backend implementation
  • Gaindu & Shalon: Mobile app development, Web Dhasboard & Backend implementation
  • Lehan & Pavith: Web dashboard development, Backend, React implementation
  • All Members: Testing, documentation, and quality assurance

Development Timeline

Phase 1 (July 31 - Aug 2)

  • ✅ Repository setup and project structure
  • ✅ Static UI development for mobile and web
  • ✅ Database schema implementation
  • ✅ Mock data population

Phase 2 (Aug 3 - Aug 5)

  • ✅ Backend API development
  • ✅ Frontend-backend integration
  • ✅ Real-time features implementation
  • 🔄 AI chatbot integration

Final Phase (Aug 6 - Aug 7)

  • 🔄 DPI integration (SLUDI, NDX, PayDPI)
  • 🔄 Testing and bug fixes
  • 🔄 Documentation completion
  • 🔄 Demo preparation

Expected Outcomes

  1. Faster Emergency Response: Real-time SOS and disaster alerts
  2. Optimized Resource Allocation: AI-powered supply distribution
  3. Enhanced Citizen Engagement: Two-way communication platform
  4. Transparent Operations: Public visibility into relief efforts
  5. Scalable Solution: Exportable to other disaster-prone regions

🔧 Configuration

Environment Variables

Mobile App (config/api.ts)

export const API_BASE_URL = 'http://10.0.2.2:5000'; // Android Emulator
// export const API_BASE_URL = 'http://localhost:5000'; // iOS Simulator

API Configuration

  • Base URL: http://localhost:5000 (development)
  • Authentication: Bearer token in Authorization header
  • Content-Type: application/json

Emergency Features

SOS Signal

  • One-tap emergency button
  • Automatic GPS location capture
  • Priority level selection (High/Medium/Low)
  • Message field for additional details

Real-time Alerts

  • Push notifications for new disasters
  • Location-based risk assessment
  • Weather integration
  • Offline capability

AI Safety Assistant

  • Natural language processing
  • Contextual safety recommendations
  • Pre-defined quick questions
  • Emergency contact information

📱 Mobile App Features

Authentication

  • SLUDI mock authentication
  • Role-based access (Citizen/Responder)
  • Secure token storage

Dashboard

  • Current location weather
  • Risk assessment based on nearby disasters
  • Quick action buttons (SOS, Report, Chat)
  • Recent alerts feed
  • Available resources display

Reporting

  • Incident type selection
  • Photo upload capability
  • Location confirmation
  • Status tracking

Web Dashboard Features

Admin Panel

  • Role-based access control
  • Real-time statistics
  • Geographic data visualization
  • Resource management

Disaster Management

  • Create and update disasters
  • Set severity levels
  • Publish public alerts
  • Status tracking

SOS Monitoring

  • Live emergency signal feed
  • Priority-based sorting
  • Geographic clustering
  • Response assignment

Security Features

  • JWT token authentication
  • Role-based access control
  • Input validation and sanitization
  • Secure API endpoints
  • Environment variable protection

Troubleshooting

Common Issues

  1. MongoDB Connection Error

    • Verify MONGO_URI in .env file
    • Check network connectivity
    • Ensure IP whitelist in MongoDB Atlas

  2. Mobile App API Connection

    • Use 10.0.2.2 for Android emulator
    • Use localhost for iOS simulator
    • Check backend server is running

  3. GPS Location Issues

    • Enable location permissions
    • Check device GPS settings
    • Verify location services are enabled

Debug Commands

# Check backend logs
cd src/web-dashboard/backend
npm start

# Check mobile app logs
cd src/MobileApp
npx react-native log-android
npx react-native log-ios

# Reset database
npm run seed

Documentation

License

This project is licensed under the Apache License 2.0 — you are free to use, modify, and distribute this software, provided that proper credit is given to the original developers and a copy of this license is included.

See the LICENSE file for full details.

Acknowledgments

  • Sri Lanka Digital Public Infrastructure (DPI) team
  • React Native and React communities
  • MongoDB Atlas for database hosting
  • OpenWeatherMap for weather data
  • Google Maps for mapping services

Built with ❤️ for Sri Lanka's disaster response needs

This platform demonstrates the potential of AI and modern technology in addressing critical national challenges.