How chinmoykk3/campusfind-ai works
CampusFind AI is a campus lost-and-found platform with student web/mobile applications and an administrator panel. The intended user journey is to report or find a lost item, use AI-assisted matching to identify a possible match, and support follow-up through notifications; administrators also manage users and view dashboard data. The sampled backend confirms authentication and admin routes, plus MongoDB setup and seeded categories/locations. The README describes AI capabilities, but their implementation and wiring—and the report routes’ mounting—are not shown in the excerpts.
Main entry points: app.js Express API · server.js Backend Startup · seedDatabase.js Category / Location Seeds · auth.routes.js Auth Routes
Components 24
Clients
- Student Web / Mobile
- Administrator Panel
Backend API
- Express API
backend/src/app.js - Auth Routes
backend/src/auth/auth.routes.js - Auth Controller
backend/src/auth/auth.controller.js - Auth Service
backend/src/auth/auth.service.js - Admin Routes
backend/src/admin/admin.routes.js - Admin Controller
backend/src/admin/admin.controller.js - Admin User Routes
backend/src/admin/admin.user.routes.js - User Admin Controller
backend/src/admin/admin.user.controller.js - Admin Services
backend/src/admin
Lost And Found
- Lost / Found Reports
backend/src/reports - AI Hybrid Matching
- Notifications
backend/src/models/Notification.js
Data And Setup
- User Model
backend/src/models/User.js - MongoDB
- Backend Startup
backend/src/server.js - Database Connection
backend/src/config/database.js - Index Initialization
backend/src/database/initializeDatabase.js - Category / Location Seeds
backend/src/database/seedDatabase.js - Category Model
backend/src/models/Category.js - Location Model
backend/src/models/Location.js
Other components
- Students
- Administrators
Connections 21
- Students → Student Web / Mobile: use
- Administrators → Administrator Panel: use
- Student Web / Mobile → Express API: request
- Administrator Panel → Express API: request
- Express API → Auth Routes: mounts
- Express API → Admin Routes: mounts
- Express API → Admin User Routes: mounts
- Auth Routes → Auth Controller: dispatches
- Auth Controller → Auth Service: calls
- Auth Service → User Model: reads / writes
- Admin Routes → Admin Controller: dispatches
- Admin Controller → Admin Services: calls
- Admin User Routes → User Admin Controller: dispatches
- User Admin Controller → Admin Services: calls
- Backend Startup → Express API: starts
- Backend Startup → Database Connection: connects
- Backend Startup → Index Initialization: initializes
- Backend Startup → Category / Location Seeds: seeds
- Database Connection → MongoDB: connects
- Category / Location Seeds → Category Model: upserts
- Category / Location Seeds → Location Model: upserts