Aegis AI - Smart City Infrastructure Monitoring

Aegis AI is a mobile app that enables residents to report street infrastructure issues (potholes, broken streetlights, damaged sidewalks) using photos, AI classification, and geolocation, with a real-time city dashboard for municipal workers.

Architecture

• Mobile App: React Native (iOS/Android)
• Backend API: Python FastAPI
• AI/CV: PyTorch/TensorFlow for image classification
• Web Dashboard: React + Mapbox/Leaflet
• Database: PostgreSQL + PostGIS (geospatial)
• Cloud: AWS/GCP with Docker, S3/Cloud Storage for images

Project Structure

aegis-ai/
├── mobile/                 # React Native app
├── backend/                # FastAPI backend
│   ├── app/
│   │   ├── api/           # API routes
│   │   ├── models/        # DB models
│   │   ├── services/      # Business logic
│   │   └── ml/            # ML inference
│   ├── Dockerfile
│   └── requirements.txt
├── web-dashboard/          # React dashboard
├── ml-model/               # Training scripts
│   ├── train.py
│   ├── data/
│   └── models/
├── docker-compose.yml
├── .gitignore
└── README.md

Quick Start

Prerequisites

• Docker and Docker Compose
• Node.js 18+
• Python 3.9+

Development Setup

1. Clone the repository
2. Start the database: docker-compose up -d postgres
3. Setup backend: cd backend && pip install -r requirements.txt
4. Setup mobile app: cd mobile && npm install
5. Setup web dashboard: cd web-dashboard && npm install

Running the Application

1. Start backend: cd backend && uvicorn app.main:app --reload
2. Start web dashboard: cd web-dashboard && npm start
3. Start mobile app: cd mobile && npx react-native run-android (or run-ios)

API Documentation

Once the backend is running, visit http://localhost:8000/docs for interactive API documentation.

Contributing

Please read our contributing guidelines before submitting pull requests.

License

This project is licensed under the MIT License.