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
- 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
Frontend
cd frontend
npm install
npm run dev
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.