How sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system works
UniTrace is a console-based campus lost-and-found application. Students search found items, file lost-item reports, and submit item-specific proof to claim an item; an administrator logs found items, reviews claims, verifies pickup identity, and releases items with a receipt. The in-memory registry owns item search, report matching, claim state transitions, and release. The README documents these capabilities; sampled source confirms the main UI-to-registry flow and claim lifecycle. Unshown implementations are represented only where the README or source index supports them.
Main entry points: ItemRegistry.java In-memory registry · ConsoleUI.java Role menus · Item.java Found item model · ClaimRequest[1].java Claim request
Components 24
Console experience
- Role menus
ConsoleUI.java - Console input
InputHelper.java - Admin guard
AdminGuard.java
Item and report domain
- Student
Student.java - User
User.java - Found item model
Item.java - Item categories
ItemCategory.java - Item statuses
ItemStatus.java - Student ID item
StudentIDCard.java - Electronics item
Electronics.java - Personal belonging
PersonalBelonging.java - Lost-item report
LostReport.java - Match result
MatchResult[1].java - Item lookup errors
ItemNotFoundException.java
Claim lifecycle
- Claim processing
ClaimProcessor.java - Claim request
ClaimRequest[1].java - Claim statuses
ClaimStatus[1].java - Proof contract
Claimable.java - Claim errors
InvalidClaimException.java - Transition errors
InvalidStatusTransitionException.java
Application runtime
- In-memory registry
ItemRegistry.java - Text utilities
TextUtil.java - Program entry
Main.java
Other components
- Student or admin
Connections 29
- Program entry → In-memory registry: creates and seeds
Main.java - Program entry → Role menus: starts
Main.java - Student or admin → Role menus: uses menus
README.md - Role menus → Console input: reads input
ConsoleUI.java - Role menus → Admin guard: authenticates admin
ConsoleUI.java - Role menus → In-memory registry: requests operations
ConsoleUI.java - Role menus → Lost-item report: creates reports
ConsoleUI.java - Role menus → Student ID item: constructs item
ConsoleUI.java - Role menus → Electronics item: constructs item
ConsoleUI.java - Role menus → Personal belonging: constructs item
ConsoleUI.java - Role menus → Claim request: displays claims
ConsoleUI.java - In-memory registry → Found item model: stores and searches
ItemRegistry.java - In-memory registry → Lost-item report: stores and matches
ItemRegistry.java - In-memory registry → Match result: returns matches
ItemRegistry.java - In-memory registry → Claim request: creates and updates
ItemRegistry.java - In-memory registry → Claim processing: implements
ItemRegistry.java - In-memory registry → Claim errors: throws
ItemRegistry.java - In-memory registry → Transition errors: throws
ItemRegistry.java - In-memory registry → Item lookup errors: throws
ItemRegistry.java - In-memory registry → Text utilities: normalizes and formats
ItemRegistry.java - Found item model → Proof contract: implements
Item.java - Student ID item → Found item model: extends
StudentIDCard.java - Electronics item → Found item model: extends
Electronics.java - Personal belonging → Found item model: extends
PersonalBelonging.java - Found item model → Item categories: uses category
Item.java - Found item model → Item statuses: tracks lifecycle
Item.java - Student → User: extends
Student.java - Claim request → Student: records claimant
ClaimRequest[1].java - Claim request → Found item model: records claimed item
ClaimRequest[1].java