Skip to content

Latest commit

 

History

4 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 

Repository files navigation

cat << 'EOF' > README.md

🧠 Decentralized Disease Surveillance System

Turning grassroots symptom reports into real-time outbreak intelligence
Early detection • Inclusive reporting • Scalable architecture



📖 Overview

A scalable platform designed to detect disease outbreaks early by collecting real-time symptom reports from individuals, hospitals, and underserved communities.

💡 Core Idea: Bottom-up reporting → smarter outbreak detection → faster response

Key Features

  • 📡 Multi-Channel Reporting (Web + SMS ready)
  • 🌍 Rural Accessibility (low internet support)
  • 🧠 Early Detection Engine (symptom spike tracking)
  • 📊 Real-Time Dashboards (maps + charts)
  • 🔐 Role-Based Access (user vs hospital)
  • ⚙️ Scalable Backend (Node + Mongo)
  • 🤖 ML Detection (coming soon)
  • 📢 Alert System (SMS / Email / WhatsApp)

🏗️ Tech Stack

LayerTech
FrontendReact (Vite), Tailwind CSS
BackendNode.js, Express.js
DatabaseMongoDB Atlas
DevOpsDocker, GitHub Actions, Render

⚙️ Installation

```bash git clone https://github.com/your-username/your-repo.git cd your-repo

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


▶️ Run Project

```bash cd backend && npm run dev cd frontend && npm run dev ```


🔑 Environment

```env PORT=5000 MONGO_URI=your_mongodb_uri JWT_SECRET=your_secret ```


📊 Architecture

``` User/Hospital/SMS ↓ Frontend (React) ↓ Backend (Express) ↓ MongoDB ↓ Analytics / ML ↓ Dashboard + Alerts ```


👥 Usage Flow

User submits symptoms → Data stored → System detects spike → Dashboard updates → Alerts triggered

🧪 Status

Feature Status
MVP
Auth
Deployment
CI/CD 🔄
Dashboards 🔄
ML

🛣️ Roadmap

  • ML anomaly detection
  • SMS reporting
  • Interactive dashboards
  • Alert system
  • NGO testing
  • Global rollout

🎯 Use Cases

  • 🦠 Outbreak detection
  • 🏥 Hospital monitoring
  • 🌾 Rural healthcare
  • 🌍 Public health analytics

🤝 Contributing

```bash git checkout -b feature/yourFeature git commit -m "Added feature" git push origin feature/yourFeature ```


📜 License

MIT License


Quick Pitch

A system that converts real-time symptom reports into early outbreak detection using analytics and future ML.


Built for impact • Designed for scale • Ready for the real world

EOF

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages