How shanmukha-veera-sai/campus-l-f works
Campus Lost & Found is a student-facing portal for reporting and searching lost/found items, verifying ownership claims, coordinating handovers, and managing profiles and notifications. The principal workflow runs from a student’s listing search through a claim request and reporter review to restricted messaging. The README also documents session authentication, photo uploads, and profile management. Source excerpts establish several service-level calls; other documented feature links are shown from the README where controller or frontend wiring was not sampled.
Main entry points: app.js Portal UI · ClaimRequestService.java Claim review · ConversationService.java Claim-restricted chat · StudentService.java Student profiles
Components 23
Student experience
- Portal UI
src/main/resources/static/js/app.js
Identity and profiles
- Authentication API
src/main/java/com/campus/lostfound/controller/AuthController.java - Profile API
src/main/java/com/campus/lostfound/controller/ProfileController.java - Student profiles
src/main/java/com/campus/lostfound/service/StudentService.java - Student records
src/main/java/com/campus/lostfound/entity/Student.java
Listings and claims
- Item reports API
src/main/java/com/campus/lostfound/controller/ItemReportController.java - Listing search and CRUD
src/main/java/com/campus/lostfound/service/ItemReportService.java - Item reports
src/main/java/com/campus/lostfound/entity/ItemReport.java - Claims API
src/main/java/com/campus/lostfound/controller/ClaimRequestController.java - Claim review
src/main/java/com/campus/lostfound/service/ClaimRequestService.java - Claim records
src/main/java/com/campus/lostfound/entity/ClaimRequest.java
Handover and updates
- Chat API
src/main/java/com/campus/lostfound/controller/ChatController.java - Claim-restricted chat
src/main/java/com/campus/lostfound/service/ConversationService.java - Conversations
src/main/java/com/campus/lostfound/entity/Conversation.java - Chat messages
src/main/java/com/campus/lostfound/entity/Message.java - Notifications API
src/main/java/com/campus/lostfound/controller/NotificationController.java - Notification delivery
src/main/java/com/campus/lostfound/service/NotificationService.java - Notification records
src/main/java/com/campus/lostfound/entity/Notification.java
Persistence and support
- Photo storage
src/main/java/com/campus/lostfound/service/FileStorageService.java - API response wrapper
src/main/java/com/campus/lostfound/dto/ApiResponse.java - Error responses
src/main/java/com/campus/lostfound/exception/GlobalExceptionHandler.java - MySQL database
Other components
- Student
Connections 32
- Student → Portal UI: uses
- Portal UI → Authentication API: authenticates
- Portal UI → Profile API: manages profile
- Portal UI → Item reports API: searches listings
- Portal UI → Claims API: submits claims
- Portal UI → Chat API: coordinates handover
- Portal UI → Notifications API: checks updates
- Authentication API → Student profiles: delegates to
src/main/java/com/campus/lostfound/controller/AuthController.java - Profile API → Student profiles: delegates to
src/main/java/com/campus/lostfound/controller/ProfileController.java - Student profiles → Student records: manages
src/main/java/com/campus/lostfound/service/StudentService.java - Student profiles → Photo storage: stores photos
src/main/java/com/campus/lostfound/service/StudentService.java - Item reports API → Listing search and CRUD: delegates to
src/main/java/com/campus/lostfound/controller/ItemReportController.java - Listing search and CRUD → Item reports: manages
src/main/java/com/campus/lostfound/service/ItemReportService.java - Listing search and CRUD → Photo storage: stores photos
src/main/java/com/campus/lostfound/service/ItemReportService.java - Claims API → Claim review: delegates to
src/main/java/com/campus/lostfound/controller/ClaimRequestController.java - Claim review → Claim records: creates and reviews
src/main/java/com/campus/lostfound/service/ClaimRequestService.java - Claim review → Notification delivery: notifies participants
src/main/java/com/campus/lostfound/service/ClaimRequestService.java - Claim review → Conversations: opens conversation
src/main/java/com/campus/lostfound/service/ClaimRequestService.java - Chat API → Claim-restricted chat: delegates to
src/main/java/com/campus/lostfound/controller/ChatController.java - Claim-restricted chat → Conversations: checks and manages
src/main/java/com/campus/lostfound/service/ConversationService.java - Claim-restricted chat → Chat messages: stores messages
src/main/java/com/campus/lostfound/service/ConversationService.java - Claim-restricted chat → Notification delivery: notifies recipient
src/main/java/com/campus/lostfound/service/ConversationService.java - Notifications API → Notification delivery: delegates to
src/main/java/com/campus/lostfound/controller/NotificationController.java - Notification delivery → Notification records: creates and maps
src/main/java/com/campus/lostfound/service/NotificationService.java - Student profiles → MySQL database: persists profiles
- Listing search and CRUD → MySQL database: persists listings
- Claim review → MySQL database: persists claims
- Claim-restricted chat → MySQL database: persists chat
- Notification delivery → MySQL database: persists notifications
src/main/java/com/campus/lostfound/service/NotificationService.java - Photo storage → Student records: stores photo paths
- Photo storage → Item reports: stores photo paths
- API response wrapper → Error responses: formats errors
src/main/java/com/campus/lostfound/exception/GlobalExceptionHandler.java