How vignana-jyothi/easyfind works
EasyFind is a campus lost-and-found product with separate student and administrator web apps, an Express/MongoDB backend, and a separate authentication service. Students sign in, report lost items, search found-item listings, and view reports or notifications; administrators manage found items and complete verified handovers. The backend also matches lost and found reports and dispatches email and in-app notifications. Some frontend-to-backend wiring is not shown in the excerpts, so those relationships are omitted or marked unverified.
Main entry points: emailDispatcher.js Match and email dispatch · server.js API server · App.jsx Student routes · admin.route.js Admin item routes
Components 30
Student app
- Student routes
frontend/fe9-easyfind-child/src/App/App.jsx - Student auth state
frontend/fe9-easyfind-child/src/contexts/AuthContext.jsx - Dashboard
frontend/fe9-easyfind-child/src/components/UserHome.jsx - Search found items
frontend/fe9-easyfind-child/src/components/SearchItem.jsx - Report lost item
frontend/fe9-easyfind-child/src/components/ReportItem.jsx - My reports
frontend/fe9-easyfind-child/src/components/MyReports.jsx - Date formatting
frontend/fe9-easyfind-child/src/utils/dateHelper.js
Admin app
- Admin routes
frontend/fe9-easyfind-admin/src/App.jsx - Manage items
frontend/fe9-easyfind-admin/src/components/ManageItems.jsx - Edit found item
frontend/fe9-easyfind-admin/src/components/EditItem.jsx - Student handover
frontend/fe9-easyfind-admin/src/components/GiveToStudent.jsx
EasyFind backend
- API server
backend/be9-easyfind/server.js - Authentication routes
backend/be9-easyfind/routes/auth.route.js - Student item routes
backend/be9-easyfind/routes/user.route.js - Admin item routes
backend/be9-easyfind/routes/admin.route.js - Notification routes
backend/be9-easyfind/routes/notification.route.js - Student authorization
backend/be9-easyfind/middlewares/user-auth.js - Match and email dispatch
backend/be9-easyfind/utils/emailDispatcher.js - Item matching
backend/be9-easyfind/utils/matchingAlgorithm.js
Data and integrations
- Lost item records
backend/be9-easyfind/models/LostItem.js - Found item records
backend/be9-easyfind/models/FoundItem.js - User records
backend/be9-easyfind/models/User.js - Notifications
backend/be9-easyfind/models/Notification.js - Email queue
backend/be9-easyfind/models/EmailNotification.js - Email delivery
backend/be9-easyfind/utils/notifications.js
Other components
- Student
- Administrator
- Google auth service
backend/auth-server/server.js - MongoDB
- Cloudinary
Connections 35
- Student → Student routes: uses
frontend/fe9-easyfind-child/src/App/App.jsx - Student routes → Student auth state: provides auth
frontend/fe9-easyfind-child/src/App/App.jsx - Student routes → Dashboard: routes to
frontend/fe9-easyfind-child/src/App/App.jsx - Student routes → Search found items: routes to
frontend/fe9-easyfind-child/src/App/App.jsx - Student routes → Report lost item: routes to
frontend/fe9-easyfind-child/src/App/App.jsx - Student routes → My reports: routes to
frontend/fe9-easyfind-child/src/App/App.jsx - My reports → Date formatting: formats dates
frontend/fe9-easyfind-child/src/components/MyReports.jsx - Student auth state → Google auth service: checks login
frontend/fe9-easyfind-child/src/contexts/AuthContext.jsx - Search found items → Student item routes: fetches listings
frontend/fe9-easyfind-child/src/components/SearchItem.jsx - Administrator → Admin routes: uses
frontend/fe9-easyfind-admin/src/App.jsx - Admin routes → Manage items: routes to
frontend/fe9-easyfind-admin/src/App.jsx - Admin routes → Edit found item: routes to
frontend/fe9-easyfind-admin/src/App.jsx - Admin routes → Student handover: routes to
frontend/fe9-easyfind-admin/src/App.jsx - API server → Authentication routes: mounts
backend/be9-easyfind/server.js - API server → Student item routes: mounts
backend/be9-easyfind/server.js - API server → Admin item routes: mounts
backend/be9-easyfind/server.js - API server → Notification routes: mounts
backend/be9-easyfind/server.js - Authentication routes → Google auth service: proxies login
backend/be9-easyfind/routes/auth.route.js - Student item routes → Student authorization: authorizes requests
backend/be9-easyfind/routes/user.route.js - Student authorization → User records: syncs user
backend/be9-easyfind/middlewares/user-auth.js - Student item routes → Lost item records: reads and writes
backend/be9-easyfind/routes/user.route.js - Student item routes → Found item records: reads and writes
backend/be9-easyfind/routes/user.route.js - Admin item routes → Lost item records: accesses reports
backend/be9-easyfind/routes/admin.route.js - Admin item routes → Found item records: manages items
backend/be9-easyfind/routes/admin.route.js - Admin item routes → Notifications: creates notices
backend/be9-easyfind/routes/admin.route.js - Notification routes → Notifications: reads notices
backend/be9-easyfind/routes/notification.route.js - Match and email dispatch → Lost item records: loads reports
backend/be9-easyfind/utils/emailDispatcher.js - Match and email dispatch → Found item records: loads found items
backend/be9-easyfind/utils/emailDispatcher.js - Match and email dispatch → Item matching: scores matches
backend/be9-easyfind/utils/emailDispatcher.js - Match and email dispatch → Email queue: processes queue
backend/be9-easyfind/utils/emailDispatcher.js - Match and email dispatch → Notifications: creates notices
backend/be9-easyfind/utils/emailDispatcher.js - Match and email dispatch → Email delivery: sends email
backend/be9-easyfind/utils/emailDispatcher.js - API server → Match and email dispatch: starts scheduler
backend/be9-easyfind/server.js - API server → MongoDB: connects
backend/be9-easyfind/server.js - Admin item routes → Cloudinary: uploads images