How 21-sharanya/campusfind works
CampusFind is a campus lost-and-found portal. Students post lost or found items, browse and filter listings, inspect a listing, and can submit a verification-answer claim; finders can review claims, while posters use a PIN to edit, delete, or mark items returned. The client calls an Express API whose controller enforces these operations, persists item records, and computes match suggestions. The README documents the full feature set; some client and server implementation details were not sampled, so those relationships are shown only where the excerpts or documentation support them.
Main entry points: api.js HTTP client · App.jsx Page router · ItemDetail.jsx Item detail · Report.jsx Report item
Components 19
Student portal
- Page router
client/src/App.jsx - Recent items
client/src/pages/Home.jsx - Search & filters
client/src/pages/Browse.jsx - Report item
client/src/pages/Report.jsx - Item form
client/src/components/ReportForm.jsx - Item detail
client/src/pages/ItemDetail.jsx - Claim submission
client/src/components/ClaimForm.jsx - Claim review
client/src/components/ClaimsList.jsx - Match suggestions
client/src/components/MatchPanel.jsx - Edit item
client/src/pages/EditItem.jsx - HTTP client
client/src/api.js
Item API
- Item routes
server/routes/itemRoutes.js - Item operations
server/controllers/Itemcontroller.js - Error responses
server/middleware/errorHandler.js
Matching
- Match scoring
server/utils/matchScore.js
Persistence
- Item schema
server/models/Item.js - Database connection
server/config/db.js
Other components
- Student
- MongoDB
Connections 24
- Student → Page router: uses portal
README.md - Page router → Recent items: routes to
client/src/App.jsx - Page router → Search & filters: routes to
client/src/App.jsx - Page router → Item detail: routes to
client/src/App.jsx - Page router → Edit item: routes to
client/src/App.jsx - Page router → Report item: routes to
client/src/App.jsx - Recent items → HTTP client: fetches listings
client/src/pages/Home.jsx - Search & filters → HTTP client: searches listings
client/src/pages/Browse.jsx - Report item → HTTP client: creates item
client/src/pages/Report.jsx - Report item → Item form: renders
client/src/pages/Report.jsx - Item detail → HTTP client: loads and updates
client/src/pages/ItemDetail.jsx - Item detail → Claim submission: renders
client/src/pages/ItemDetail.jsx - Item detail → Claim review: renders claims
client/src/pages/ItemDetail.jsx - Item detail → Match suggestions: renders matches
client/src/pages/ItemDetail.jsx - Edit item → HTTP client: updates item
client/src/pages/EditItem.jsx - Edit item → Item form: renders
client/src/pages/EditItem.jsx - Claim submission → HTTP client: submits claim
client/src/components/ClaimForm.jsx - Match suggestions → HTTP client: requests matches
client/src/components/MatchPanel.jsx - HTTP client → Item routes: sends HTTP requests
README.md - Item routes → Item operations: dispatches requests
server/routes/itemRoutes.js - Item operations → Item schema: reads and writes
server/controllers/Itemcontroller.js - Item operations → Match scoring: scores candidates
server/controllers/Itemcontroller.js - Database connection → MongoDB: connects to
server/config/db.js - Item schema → MongoDB: persists records
README.md