Fix Karachi: e-City Portal

Project Overview

Fix Karachi: e-City Portal is a smart governance and urban issue management platform designed to bridge the gap between citizens and municipal authorities. The system enables citizens to digitally report civic issues (such as potholes, garbage collection, water leaks, and streetlight faults), track progress in real time, and engage with city administration transparently.

This project was developed as part of an SDA (Software Design & Architecture) course project, following a Hybrid SDLC (Waterfall + Agile) approach.

---

Vision

To transform Karachi into a smarter, more responsive, and transparent city by leveraging modern web and mobile technologies that promote civic engagement and data-driven governance.

---

Background & Problem Statement

Modern cities face daily civic challenges, but existing manual complaint-handling systems suffer from:

• Delays in resolution
• Lack of transparency
• Poor accountability
• No real-time tracking

The E-City Portal solves these problems by providing a centralized digital platform where all stakeholders collaborate efficiently.

---

✅ Project Goals

• Digital Issue Reporting – Simple and intuitive complaint submission
• Efficient Issue Management – Structured tracking and resolution
• Transparency & Accountability – Real-time status updates
• Role-Based Access Control – Separate dashboards for each role
• Community Engagement – Public feed and citizen feedback
• Automated Moderation – Content filtering before escalation

---

System Roles

• Citizen – Submit and track complaints, interact with community feed
• Moderator – Review and filter submitted content
• Department Officer – Resolve assigned complaints
• Admin – System oversight, analytics, and assignment control

---

Organizational Hierarchy

1. Admin Board (Top Authority)

   • System oversight
   • Final moderation approval
   • Department assignment

2. Moderators

   • Content screening and verification

3. Departments

   • Department Manager
   • Field Employees

4. Citizens

   • Complaint submission and feedback

---

🔄 SDLC Model Used – Hybrid Approach

Waterfall (Planning & Design)

• Clear requirement definition
• System architecture design
• Defined permissions & hierarchy

Agile (Development & Testing)

• Sprint-based implementation
• Iterative improvements
• Continuous feedback integration

Why Hybrid? Government systems require stability, while citizen-facing features demand flexibility—this model ensures both.

---

Project Timeline

Phase	Description	Duration
Planning	Scope, objectives, risk assessment	2 Weeks
Requirements Analysis	Functional & non-functional requirements	3 Weeks
Development	Architecture, coding, integration	8 Weeks
Testing	Unit, integration & UAT testing	4 Weeks
Deployment	Launch & post-launch support	1 Week

---

🖥️ System Architecture

A scalable client–server architecture with secure APIs and cloud deployment.

Tech Stack

Frontend

• React.js (Web)
• React Native (Mobile)
• Tailwind CSS
• Redux Toolkit

Backend

• Node.js + Express.js (REST APIs)

Database

• MongoDB Atlas (Primary)
• PostgreSQL (Alternative)

Authentication & Services

• JWT / Firebase Authentication
• Google Maps API
• Cloudinary (Media Storage)

CI/CD & Deployment

• GitHub Actions
• Vercel (Web)
• Render / Railway (Backend)
• Expo & Play Store (Mobile)

---

Expected REST API Endpoints

Authentication & Verification

• POST /auth/register – Register user (CNIC/Passport)
• POST /auth/login – Login & token generation
• POST /auth/verify-cnic – CNIC verification via NADRA API
• GET /auth/profile – Fetch user profile

User Management

• PUT /user/update – Update user profile
• GET /user/{id} – Fetch user details

Complaint Management

• POST /complaints/create – Submit complaint
• GET /complaints/{id} – Get complaint by ID
• GET /complaints/user/{userId} – User-specific complaints
• GET /complaints – All complaints (Admin)
• PUT /complaints/{id}/status – Update complaint status
• PUT /complaints/{id}/assign – Assign to department

ML Tagging

• POST /ml/tag – Auto category & priority detection

Community Feed

• POST /feed/post – Create public post
• GET /feed – Get feed
• GET /feed/{id} – Single post details

Media Upload

• POST /media/upload – Upload media
• GET /media/{filename} – Access media

Moderation & Admin

• POST /moderation/check – Auto content moderation
• PUT /moderation/flag/{postId} – Flag content
• GET /admin/dashboard – System statistics
• GET /admin/officers – List officers
• PUT /admin/assign/{complaintId} – Assign complaint

---

UI & Prototyping

• User Dashboard (Citizen)
• Admin Dashboard
• Moderator Panel
• Figma-based UI Prototype

---

Future Enhancements

• 🔊 Speech-to-Text complaint entry
• 🌐 Multilingual support (Urdu, English, Sindhi)
• 🏙️ Expansion to other cities
• 📊 Advanced analytics & AI insights

---

Project Impact

• Strengthens citizen–government communication
• Improves response time and accountability
• Enables smart, data-driven governance
• Enhances urban liveability

---

Team Commitment

We are committed to applying the knowledge and skills gained from this project in our future academic and professional journeys, contributing positively to society and the tech ecosystem.

---

Fix Karachi e-City Portal – Towards a Smarter, Connected City 🚀