How goyal-nandini/claimit works
ClaimIt is a campus lost-and-found application. Students browse and search lost/found reports, post items, and submit claims; owners review claims, approve or reject them, and approved claims resolve the item and reveal owner contact details. The React client uses a shared API service to communicate with an Express API backed by MongoDB, with Cloudinary image storage and email notifications. Relationships among backend routes, controllers, and models are supported by the sampled source; some client-to-API links are documented capabilities rather than inspected call sites.
Main entry points: api.js API Client · App.jsx Page Router · server.js Express Server · itemRoutes.js Item Routes
Components 25
Student Web App
- Page Router
client/src/App.jsx - Browse Items
client/src/pages/ItemsPage.jsx - Item Details
client/src/pages/ItemDetailPage.jsx - Report Item
client/src/pages/PostItemPage.jsx - My Posts
client/src/pages/MyPostsPage.jsx - My Claims
client/src/pages/MyClaimsPage.jsx - Claims Panel
client/src/components/ClaimsPanel.jsx - Auth State
client/src/context/AuthContext.jsx - API Client
client/src/services/api.js
API and Workflows
- Express Server
server/server.js - Auth Routes
server/routes/authRoutes.js - Item Routes
server/routes/itemRoutes.js - Claim Routes
server/routes/claimRoutes.js - Authentication
server/controllers/authController.js - Item Workflow
server/controllers/itemController.js - Claim Workflow
server/controllers/claimController.js - JWT Guard
server/middleware/authMiddleware.js
Persistent Data
- User Records
server/models/User.js - Item Records
server/models/Item.js - Claim Records
server/models/Claim.js
External Services
- Image Upload
server/utils/cloudinary.js - Email Sender
server/utils/sendEmail.js - Cloudinary
- Email Provider
Other components
- Student
Connections 33
- Student → Page Router: uses
README.md - Page Router → Browse Items: routes to
client/src/App.jsx - Page Router → Item Details: routes to
client/src/App.jsx - Page Router → Report Item: protects route
client/src/App.jsx - Page Router → My Posts: protects route
client/src/App.jsx - Page Router → My Claims: protects route
client/src/App.jsx - My Posts → Claims Panel: renders
client/src/pages/MyPostsPage.jsx - Auth State → API Client: stores credentials
- Browse Items → API Client: requests listings
client/src/pages/ItemsPage.jsx - Item Details → API Client: requests item
client/src/pages/ItemDetailPage.jsx - Report Item → API Client: submits report
client/src/pages/PostItemPage.jsx - My Posts → API Client: requests posts
client/src/pages/MyPostsPage.jsx - My Claims → API Client: requests claims
client/src/pages/MyClaimsPage.jsx - Claims Panel → API Client: manages claims
client/src/components/ClaimsPanel.jsx - API Client → Express Server: calls API
README.md - Express Server → Auth Routes: mounts routes
server/server.js - Express Server → Item Routes: mounts routes
server/server.js - Express Server → Claim Routes: mounts routes
server/server.js - Auth Routes → Authentication: dispatches
server/routes/authRoutes.js - Item Routes → Item Workflow: dispatches
server/routes/itemRoutes.js - Claim Routes → Claim Workflow: dispatches
server/routes/claimRoutes.js - Item Routes → JWT Guard: guards
server/routes/itemRoutes.js - Claim Routes → JWT Guard: guards
server/routes/claimRoutes.js - Authentication → User Records: reads and writes
server/controllers/authController.js - Item Workflow → Item Records: reads and writes
server/controllers/itemController.js - Item Workflow → Claim Records: deletes claims
server/controllers/itemController.js - Item Workflow → User Records: counts users
server/controllers/itemController.js - Claim Workflow → Claim Records: reads and writes
server/controllers/claimController.js - Claim Workflow → Item Records: reads and resolves
server/controllers/claimController.js - Item Routes → Image Upload: uses upload
server/routes/itemRoutes.js - Image Upload → Cloudinary: stores images
- Claim Workflow → Email Sender: sends notices
server/controllers/claimController.js - Email Sender → Email Provider: delivers mail