FindIT: Lost & Found App for VIT

Find what's lost, return what's found — fast, secure and student-only.

🌟 Overview

FindIt is a campus-exclusive platform built for VIT students to report, search, and claim lost items. With integrated image moderation, QR-based secure claims and a clean mobile interface — it ensures trust, security, and ease of use for the entire student community.

🎒 For Users Post lost/found items with images Advanced search with filters Claim items via QR verification Track all your posts and claims Image moderation to prevent abuse

🔐 For Admins Manage and moderate content Delete unsafe/inappropriate posts Track app versioning Admin-only secure endpoints

✨ Key Features

🧭 Lost & Found Flow

1. Report - Upload images, select category (lost/found), and describe the item
2. Moderate - AI-based image moderation prevents NSFW/abusive content
3. Search - Use filters or keywords to browse through reported items
4. Claim - Found your item? Request claim using the secure QR flow
5. Verify - Show your QR to the finder and verify ownership
6. Complete - Item handed over, claim closed securely!

⚠️ Note: All interactions are verified with VIT Google login. No outsiders allowed.

🛡️ Security Features

🔐 VIT-Only Access Sign in with official college email via Firebase

🖼️ AI Image Moderation NSFW detection via TensorFlow.js + NSFWJS

🔄 Secure QR Claims Time-bound, JWT-authenticated QR codes

🛠️ Admin Controls Manual moderation & unsafe post removal

🛠️ Tech Stack

Kotlin

Node.js

MongoDB

Firebase

Cloudinary

TensorFlow.js

---

📱 Application Architecture

System Architecture

┌─────────────────┐      ┌─────────────────┐      ┌─────────────────┐
│                 │      │                 │      │                 │
│   User Mobile   │◄────►│    FindIT API   │◄────►│   NSFW Check    │
│   Application   │      │    (Backend)    │      │                 │
│                 │      │                 │      └─────────────────┘
└─────────────────┘      └────────┬────────┘      
                                  │
                                  ▼
                         ┌─────────────────┐
                         │                 │
                         │    MongoDB      │
                         │    Database     │
                         │                 │
                         └─────────────────┘

Mobile Architecture

FindIT/
├── Authentication
│   └── Google Sign-In (VIT only)
├── Item Feed
│   └── Search Lost Item
│       └── Claim Lost Item
│           └── QR Code Scanner
│               └── Secure Claiming
├── Post Item
│   └── Upload Details + Image (Report Found Item)
│       └── Item Reported Successfully
└── My Profile
    ├── My Activity
    │   ├── My Claims (Claimed Item Details)
    │   └── My Reports (All Reported Items)
    │       └── List of Items Reported & Claimed
    │       └── Generate QR (For Secure Claiming)
    │       └── Delete Item
    ├── Terms & Conditions
    ├── Contact Us
    ├── Developer Team
    └── Sign Out

---

⚙️ Implementation Status

Component	Status	Notes
User Authentication	✅ Complete	Google OAuth via Firebase (VIT Email only)
Image Upload & Moderation	✅ Complete	Cloudinary + NSFWJS
Lost/Found Posting	✅ Complete	Fully functional with filters
QR Claim Flow	✅ Complete	JWT-secured, time-limited QR claims
My Items & Claims Page	✅ Complete	Users can manage their history
Admin Tools	✅ Complete	Moderation & delete functionality
App Core Features	✅ Complete	Working version deployed, UI refinements ongoing

---

🚀 Getting Started

📲 Download the App

You can download the FindIT app directly from our official website:
🌐 www.finditapp.me

Or, download the APK from our Initial Release GitHub release.

🔒 VIT Google Sign-In is required to access the app.

---

🔗 Related Repositories

• FindIT Backend

👥 Meet Our Team

Rudra Gupta App & Website Developer

Pratham Khanduja App & Backend Developer

---