How adistar350/reclaim works
ReClaim is a lost-and-found Android app backed by a Spring Boot API, MongoDB, and Firebase Storage. Its primary workflow is to register or sign in, browse/search reports or submit a found-item report, then request and review a claim before contact details are disclosed. The README also documents image storage, offline report synchronization, push notifications, and analytics. Source excerpts were not provided, so edges are limited to documented relationships; paths identify implementation locations from the tree, not inspected code.
Main entry points: ReClaimApiService.java REST client · report Item reporting · controller REST controllers · search Browse and search
Components 24
Android client
- App entry
reclaim-project/app/src/main/java/com/example/reclaim/MainActivity.java - Authentication
reclaim-project/app/src/main/java/com/example/reclaim/ui/auth - Browse and search
reclaim-project/app/src/main/java/com/example/reclaim/ui/search - Discovery dashboard
reclaim-project/app/src/main/java/com/example/reclaim/ui/dashboard - Item reporting
reclaim-project/app/src/main/java/com/example/reclaim/ui/report - Item details
reclaim-project/app/src/main/java/com/example/reclaim/ui/details/ItemDetailsActivity.java - Claim review
reclaim-project/app/src/main/java/com/example/reclaim/ui/profile/PendingClaimsSheet.java - Profile and history
reclaim-project/app/src/main/java/com/example/reclaim/ui/profile - REST client
reclaim-project/app/src/main/java/com/example/reclaim/network/ReClaimApiService.java - Offline report queue
- Push notifications
reclaim-project/app/src/main/java/com/example/reclaim/notifications
Backend API
- REST controllers
reclaim-backend/src/main/java/com/example/reclaimbackend/controller - Authentication service
reclaim-backend/src/main/java/com/example/reclaimbackend/service/AuthService.java - Item service
reclaim-backend/src/main/java/com/example/reclaimbackend/service/ItemService.java - Claim service
reclaim-backend/src/main/java/com/example/reclaimbackend/service/ClaimService.java - User service
reclaim-backend/src/main/java/com/example/reclaimbackend/service/UserService.java - Image storage service
reclaim-backend/src/main/java/com/example/reclaimbackend/service/FirebaseStorageService.java - Push delivery
reclaim-backend/src/main/java/com/example/reclaimbackend/service/PushNotificationService.java - Usage analytics
reclaim-backend/src/main/java/com/example/reclaimbackend/service/ItemService.java
Persistence and media
- MongoDB Atlas
reclaim-backend/src/main/java/com/example/reclaimbackend/repository
External services
- Firebase Storage
- Email delivery
- Maps and location
Other components
- Owner or finder
Connections 28
- Owner or finder → App entry: uses
README.md - App entry → Authentication: enters
- Owner or finder → Browse and search: searches
README.md - Owner or finder → Item reporting: submits report
README.md - Browse and search → REST client: requests results
- Discovery dashboard → REST client: loads items
- Item reporting → Offline report queue: queues offline
- Item reporting → REST client: submits item
- Item details → REST client: requests claim
- Claim review → REST client: reviews claim
- Profile and history → REST client: loads account data
- REST client → REST controllers: calls REST
README.md - Offline report queue → REST client: syncs reports
- REST controllers → Authentication service: delegates auth
- REST controllers → Item service: delegates items
- REST controllers → Claim service: delegates claims
- REST controllers → User service: delegates users
- Item service → MongoDB Atlas: stores items
README.md - Claim service → MongoDB Atlas: stores claims
README.md - Authentication service → MongoDB Atlas: stores accounts
- Image storage service → Firebase Storage: stores images
README.md - Item reporting → Firebase Storage: uploads images
- Claim service → Push delivery: triggers updates
- Push delivery → Push notifications: delivers pushes
- Authentication service → Email delivery: sends verification
- Item reporting → Maps and location: selects location
README.md - Browse and search → Maps and location: filters location
README.md - Item service → Usage analytics: supports metrics