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

Related MCP server: demo

Quick Start (Local)

Backend

Copy env

cp backend/.env.example backend/.env

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