📦 Lost & Found Management System

A full-stack web application to report, track, and recover lost or found items, built using ASP.NET Core Web API + MVC + SQL Server.

---

🚀 Key Highlights

• 🔐 Secure authentication system
• 👥 Role-based access (User & Admin)
• 📦 Complete item lifecycle tracking (Lost / Found → Collected)
• 🖼 Image upload and display functionality
• 🧩 Clean architecture (MVC + Web API separation)
• 📊 Admin dashboard with reports

---

🛠 Tech Stack

Backend (API)

• ASP.NET Core Web API (.NET 8)
• Entity Framework Core
• SQL Server

Frontend (UI)

• ASP.NET Core MVC (Razor Views)
• HttpClient (API Integration)

Database

• SQL Server

---

🧠 System Architecture

• MVC frontend communicates with Web API using HttpClient
• Web API handles business logic and database operations
• SQL Server stores user and item data
• Images stored in server (wwwroot/uploads)

Flow: User → MVC → API → Database

---

👥 Roles

👤 User

• Register & Login
• Report Lost / Found items
• Upload item images
• View all items
• Manage their own reports
• Mark item as Collected

🛠 Admin

• View all items
• Access dashboard reports
• Monitor system activity

---

✨ Features

📦 Item Management

• Add Lost / Found item
• Edit item details
• Update item status

Lost / Found → Collected

• Only item owner can update status

---

📷 Image Upload

• Upload image while reporting item
• Stored in:

wwwroot/uploads/items/

• Displayed in UI

---

📋 Item Listing

• View all items

• Displays:

  • Image
  • Item Name
  • Location
  • Status
  • Posted User

---

🔍 Search & Filtering

• Search by item name
• Filter by location and date

---

🔐 Authentication & Authorization

• Secure user registration and login
• Role-based access control
• User-specific data handling

---

📸 Screenshots

🔐 Login Page

📊 Admin Dashboard

📑 Reports (Admin)

🏠 Home - Items Listing

➕ Report Item

📋 My Reports

---

📡 API Endpoints

🔐 Auth

Method	Endpoint	Description
POST	/api/Auth/register	Register user
POST	/api/Auth/login	Login

📦 Item

Method	Endpoint	Description
GET	/api/Item	Get all items
POST	/api/Item	Add new item
GET	/api/Item/{id}	Get item by ID
PUT	/api/Item/{id}	Update item
PUT	/api/Item/status/{id}	Mark as collected
GET	/api/Item/userlist	Get user items

👤 User

Method	Endpoint	Description
GET	/api/User/{id}	Get user details

🗄 Database Schema

Users Table

• UserId
• Name
• Email
• PhoneNumber
• Password
• Role

Items Table

• ItemId
• ItemName
• Description
• Location
• Date
• Status (Lost / Found / Collected)
• ImagePath
• UserId (FK)

---

🚀 How to Run

Step 1 — Run API

1. Open LostAndFound.API
2. Run project (F5)
3. API runs at:

https://localhost:7215

4. Swagger:

https://localhost:7215/swagger

Step 2 — Run MVC

1. Open LostAndFound.Web
2. Run project (F5)
3. Open:

https://localhost:xxxx/Item

---

⚙️ Configuration

API Base URL (MVC)

File:

Services/ApiService.cs

client.BaseAddress = new Uri("https://localhost:7215/");

---

Database Connection

File: appsettings.json

"ConnectionStrings": {
  "DefaultConnection": "Server=.;Database=LostAndFoundDB;Trusted_Connection=True;"
}

---

🐛 Troubleshooting

• Ensure API is running before MVC
• Check API Base URL
• Verify image paths (/uploads/items)
• Check database connection

---

🔮 Future Enhancements

• JWT Authentication
• Email notifications
• Real-time updates (SignalR)
• Deployment on Azure
• Mobile responsive UI

---

💡 Project Objective

To build a scalable system that simplifies lost and found item tracking with structured workflows and user-friendly interaction.

👩‍💻 Author

Dheetchana K Final Year CSE Student ⭐ If you like this project, give it a star!