Skip to main content
Glama

AegisFlood (MVP)

AI-powered flood prediction and community alert system.

This repository contains a TypeScript React frontend and a FastAPI backend per the MVP scope:

  • Citizen registration and dashboard (risk view)

  • Authority dashboard (basic)

  • Simple prediction logic

  • SMS alerts via Twilio (mockable)

  • JWT auth with roles (citizen, authority)

Project Structure

. ├── backend/ │ ├── app/ │ │ ├── main.py │ │ ├── database.py │ │ ├── models.py │ │ ├── schemas.py │ │ ├── auth.py │ │ ├── prediction.py │ │ ├── alerts.py │ │ └── admin.py │ ├── data/ │ │ └── regions.json │ ├── scripts/ │ │ ├── setup_db.py │ │ └── load_regions.py │ ├── requirements.txt │ └── .env.example ├── frontend/ │ ├── index.html │ ├── package.json │ ├── tsconfig.json │ ├── tsconfig.node.json │ ├── vite.config.ts │ ├── tailwind.config.js │ ├── postcss.config.js │ └── src/ │ ├── main.tsx │ ├── App.tsx │ ├── styles/main.css │ ├── components/ │ │ ├── shared/{Button.tsx,Card.tsx,Input.tsx,StatusPill.tsx,Toggle.tsx} │ │ └── ui/{Header.tsx,NavigationBar.tsx,DashboardCard.tsx} │ ├── pages/{Home.tsx,Dashboard.tsx,Login.tsx,Registration.tsx,Settings.tsx} │ ├── context/AuthContext.tsx │ └── services/api.ts ├── docker-compose.yml └── .gitignore

Quick Start (Local)

Backend

  1. Copy env

cp backend/.env.example backend/.env
  1. Start Postgres + API

docker-compose up -d postgres python -m venv .venv && .venv/Scripts/activate pip install -r backend/requirements.txt python backend/scripts/setup_db.py python backend/scripts/load_regions.py uvicorn backend.app.main:app --reload

API: http://localhost:8000, Docs: http://localhost:8000/docs

Frontend

cd frontend npm install npm run dev

App: http://localhost:5173

Security (MVP)

  • JWT with 24h expiry, role-based access control

  • Input validation via Pydantic schemas

  • CORS restricted via FRONTEND_ORIGIN

  • Env-based secrets, no secrets in code

  • Twilio credentials via env, optional mock mode

Notes

  • This is MVP scope only. Extended features are out-of-scope until requested.

-
security - not tested
F
license - not found
-
quality - not tested

Related MCP Servers

View all related MCP servers

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/sudhans18/AegisFlood-Flood-Prediction-Community-Alert-System'

If you have feedback or need assistance with the MCP directory API, please join our Discord server