🔍 FindIt-Campus

FindIt-Campus is a full-stack Lost & Found management system designed for university campuses. It provides a centralized platform where students can report lost or found items, submit ownership claims, and allows administrators to verify claims before resolving cases. The system is built with a modern Flutter web frontend and a FastAPI backend connected to a MySQL database.

---

🚀 Features

• 📌 Report Lost or Found Items

  • Add title, category, location, date & time, and detailed description
  • Edit or delete reports before they are resolved

• 🔍 Browse Reported Items

  • Search items by title or description
  • Filter by category and status
  • Responsive dashboard with clean UI

• ✋ Submit Ownership Claims

  • Claim any reported item
  • Provide claim description and pickup location
  • Edit or withdraw claims before verification

• 📂 My Submissions

  • View all reported items
  • View all submitted claims
  • Track claim verification status
  • See who claimed your reported item after verification

• 👨‍💼 Admin Dashboard

  • View all submitted claims
  • Filter claims by status
  • Verify or reject ownership claims
  • Automatically update item status after successful verification

• 🔐 Authentication

  • Secure user login
  • Role-based access (Student & Admin)

• 🌐 Web Deployment

  • Flutter Web frontend hosted on Netlify
  • FastAPI backend deployed separately
  • MySQL database for persistent storage

---

🌍 Live Demo

👉 Live Website:
https://findit-campus15.netlify.app/

---

📸 Screenshots

📝 Sign Up Page

---

🏠 Login Page

---

📋 Dashboard

---

📦 Report Item

---

✋ Submit Claim

---

📂 My Submissions

---

👨‍💼 Admin Dashboard

---

✅ Verify Claims (Admin)

---

🏗️ System Architecture

Flutter Web
      │
      ▼
 REST API (HTTP)
      │
      ▼
FastAPI Backend
      │
      ▼
    MySQL

---

🛠️ Tech Stack

Frontend

• Flutter
• Dart
• Material Design

Backend

• FastAPI
• Python
• REST API

Database

• MySQL

Deployment

• Netlify (Frontend)
• Render (Backend)

---

📦 Main Packages

dependencies:
  flutter:
    sdk: flutter
  cupertino_icons: ^1.0.8
  http: ^1.6.0
  intl: ^0.20.2
  shared_preferences: ^2.5.3

dev_dependencies:
  flutter_test:
    sdk: flutter

---

📂 Project Structure

lib/
│
├── constant/
├── model/
├── pages/
├── services/
├── widgets/
└── main.dart

backend/
│
├── routers/
├── schemas/
├── database.py
├── main.py
└── requirements.txt

---

📌 Future Improvements

• 📧 Email notifications
• 🔔 Real-time updates using WebSockets
• 📷 Image upload support
• 🤖 AI-assisted item matching
• 📱 Android & iOS versions
• 📊 Analytics dashboard for administrators

---

👨‍💻 Author

Zuhayer Tajbid

RUET CSE-22

---

⭐ If you like this project, consider giving it a star!