# adistar350/reclaim architecture

> Architecture diagram of the GitHub repository adistar350/reclaim, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/adistar350/reclaim
- Repository: https://github.com/adistar350/reclaim

## Overview

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: [`reclaim-project/app/src/main/java/com/example/reclaim/network/ReClaimApiService.java`](https://github.com/adistar350/reclaim/blob/main/reclaim-project/app/src/main/java/com/example/reclaim/network/ReClaimApiService.java) (REST client), [`reclaim-project/app/src/main/java/com/example/reclaim/ui/report`](https://github.com/adistar350/reclaim/tree/main/reclaim-project/app/src/main/java/com/example/reclaim/ui/report) (Item reporting), [`reclaim-backend/src/main/java/com/example/reclaimbackend/controller`](https://github.com/adistar350/reclaim/tree/main/reclaim-backend/src/main/java/com/example/reclaimbackend/controller) (REST controllers), [`reclaim-project/app/src/main/java/com/example/reclaim/ui/search`](https://github.com/adistar350/reclaim/tree/main/reclaim-project/app/src/main/java/com/example/reclaim/ui/search) (Browse and search)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_mobile["Android client"]
  node_app["App entry<br/>[MainActivity.java]"]
  node_auth_ui["Authentication"]
  node_browse["Browse and search"]
  node_dashboard["Discovery dashboard"]
  node_report["Item reporting"]
  node_details["Item details"]
  node_claims_ui["Claim review"]
  node_profile["Profile and history"]
  node_api_client["REST client"]
  node_offline["Offline report queue"]
  node_notifications["Push notifications"]
end

subgraph group_server["Backend API"]
  node_api["REST controllers"]
  node_auth["Authentication service<br/>[AuthService.java]"]
  node_items["Item service<br/>[ItemService.java]"]
  node_claims["Claim service<br/>[ClaimService.java]"]
  node_users["User service<br/>[UserService.java]"]
  node_media_service["Image storage service"]
  node_push_service["Push delivery"]
  node_analytics["Usage analytics<br/>[ItemService.java]"]
end

subgraph group_data["Persistence and media"]
  node_mongo[("MongoDB Atlas")]
end

subgraph group_integrations["External services"]
  node_firebase[("Firebase Storage")]
  node_email["Email delivery"]
  node_maps["Maps and location"]
end

node_user(("Owner or finder"))

node_user -->|"uses"| node_app
node_app -.->|"enters"| node_auth_ui
node_user -->|"searches"| node_browse
node_user -->|"submits report"| node_report
node_browse -.->|"requests results"| node_api_client
node_dashboard -.->|"loads items"| node_api_client
node_report -.->|"queues offline"| node_offline
node_report -.->|"submits item"| node_api_client
node_details -.->|"requests claim"| node_api_client
node_claims_ui -.->|"reviews claim"| node_api_client
node_profile -.->|"loads account data"| node_api_client
node_api_client -->|"calls REST"| node_api
node_offline -.->|"syncs reports"| node_api_client
node_api -.->|"delegates auth"| node_auth
node_api -.->|"delegates items"| node_items
node_api -.->|"delegates claims"| node_claims
node_api -.->|"delegates users"| node_users
node_items -->|"stores items"| node_mongo
node_claims -->|"stores claims"| node_mongo
node_auth -.->|"stores accounts"| node_mongo
node_media_service -->|"stores images"| node_firebase
node_report -.->|"uploads images"| node_firebase
node_claims -.->|"triggers updates"| node_push_service
node_push_service -.->|"delivers pushes"| node_notifications
node_auth -.->|"sends verification"| node_email
node_report -->|"selects location"| node_maps
node_browse -->|"filters location"| node_maps
node_items -.->|"supports metrics"| node_analytics

click node_app "https://github.com/adistar350/reclaim/blob/main/reclaim-project/app/src/main/java/com/example/reclaim/MainActivity.java"
click node_auth_ui "https://github.com/adistar350/reclaim/tree/main/reclaim-project/app/src/main/java/com/example/reclaim/ui/auth"
click node_browse "https://github.com/adistar350/reclaim/tree/main/reclaim-project/app/src/main/java/com/example/reclaim/ui/search"
click node_dashboard "https://github.com/adistar350/reclaim/tree/main/reclaim-project/app/src/main/java/com/example/reclaim/ui/dashboard"
click node_report "https://github.com/adistar350/reclaim/tree/main/reclaim-project/app/src/main/java/com/example/reclaim/ui/report"
click node_details "https://github.com/adistar350/reclaim/blob/main/reclaim-project/app/src/main/java/com/example/reclaim/ui/details/ItemDetailsActivity.java"
click node_claims_ui "https://github.com/adistar350/reclaim/blob/main/reclaim-project/app/src/main/java/com/example/reclaim/ui/profile/PendingClaimsSheet.java"
click node_profile "https://github.com/adistar350/reclaim/tree/main/reclaim-project/app/src/main/java/com/example/reclaim/ui/profile"
click node_api_client "https://github.com/adistar350/reclaim/blob/main/reclaim-project/app/src/main/java/com/example/reclaim/network/ReClaimApiService.java"
click node_notifications "https://github.com/adistar350/reclaim/tree/main/reclaim-project/app/src/main/java/com/example/reclaim/notifications"
click node_api "https://github.com/adistar350/reclaim/tree/main/reclaim-backend/src/main/java/com/example/reclaimbackend/controller"
click node_auth "https://github.com/adistar350/reclaim/blob/main/reclaim-backend/src/main/java/com/example/reclaimbackend/service/AuthService.java"
click node_items "https://github.com/adistar350/reclaim/blob/main/reclaim-backend/src/main/java/com/example/reclaimbackend/service/ItemService.java"
click node_claims "https://github.com/adistar350/reclaim/blob/main/reclaim-backend/src/main/java/com/example/reclaimbackend/service/ClaimService.java"
click node_users "https://github.com/adistar350/reclaim/blob/main/reclaim-backend/src/main/java/com/example/reclaimbackend/service/UserService.java"
click node_media_service "https://github.com/adistar350/reclaim/blob/main/reclaim-backend/src/main/java/com/example/reclaimbackend/service/FirebaseStorageService.java"
click node_mongo "https://github.com/adistar350/reclaim/tree/main/reclaim-backend/src/main/java/com/example/reclaimbackend/repository"
click node_push_service "https://github.com/adistar350/reclaim/blob/main/reclaim-backend/src/main/java/com/example/reclaimbackend/service/PushNotificationService.java"
click node_analytics "https://github.com/adistar350/reclaim/blob/main/reclaim-backend/src/main/java/com/example/reclaimbackend/service/ItemService.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_auth_ui,node_browse,node_dashboard,node_report,node_details,node_claims_ui,node_profile,node_api_client,node_offline,node_notifications toneBlue
class node_api,node_auth,node_items,node_claims,node_users,node_media_service,node_push_service,node_analytics toneAmber
class node_mongo toneMint
class node_firebase,node_email,node_maps toneRose
class node_user toneIndigo
```

## Components

### Android client

- [App entry](https://github.com/adistar350/reclaim/blob/main/reclaim-project/app/src/main/java/com/example/reclaim/MainActivity.java): `reclaim-project/app/src/main/java/com/example/reclaim/MainActivity.java`
- [Authentication](https://github.com/adistar350/reclaim/tree/main/reclaim-project/app/src/main/java/com/example/reclaim/ui/auth): `reclaim-project/app/src/main/java/com/example/reclaim/ui/auth`
- [Browse and search](https://github.com/adistar350/reclaim/tree/main/reclaim-project/app/src/main/java/com/example/reclaim/ui/search): `reclaim-project/app/src/main/java/com/example/reclaim/ui/search`
- [Discovery dashboard](https://github.com/adistar350/reclaim/tree/main/reclaim-project/app/src/main/java/com/example/reclaim/ui/dashboard): `reclaim-project/app/src/main/java/com/example/reclaim/ui/dashboard`
- [Item reporting](https://github.com/adistar350/reclaim/tree/main/reclaim-project/app/src/main/java/com/example/reclaim/ui/report): `reclaim-project/app/src/main/java/com/example/reclaim/ui/report`
- [Item details](https://github.com/adistar350/reclaim/blob/main/reclaim-project/app/src/main/java/com/example/reclaim/ui/details/ItemDetailsActivity.java): `reclaim-project/app/src/main/java/com/example/reclaim/ui/details/ItemDetailsActivity.java`
- [Claim review](https://github.com/adistar350/reclaim/blob/main/reclaim-project/app/src/main/java/com/example/reclaim/ui/profile/PendingClaimsSheet.java): `reclaim-project/app/src/main/java/com/example/reclaim/ui/profile/PendingClaimsSheet.java`
- [Profile and history](https://github.com/adistar350/reclaim/tree/main/reclaim-project/app/src/main/java/com/example/reclaim/ui/profile): `reclaim-project/app/src/main/java/com/example/reclaim/ui/profile`
- [REST client](https://github.com/adistar350/reclaim/blob/main/reclaim-project/app/src/main/java/com/example/reclaim/network/ReClaimApiService.java): `reclaim-project/app/src/main/java/com/example/reclaim/network/ReClaimApiService.java`
- **Offline report queue**
- [Push notifications](https://github.com/adistar350/reclaim/tree/main/reclaim-project/app/src/main/java/com/example/reclaim/notifications): `reclaim-project/app/src/main/java/com/example/reclaim/notifications`

### Backend API

- [REST controllers](https://github.com/adistar350/reclaim/tree/main/reclaim-backend/src/main/java/com/example/reclaimbackend/controller): `reclaim-backend/src/main/java/com/example/reclaimbackend/controller`
- [Authentication service](https://github.com/adistar350/reclaim/blob/main/reclaim-backend/src/main/java/com/example/reclaimbackend/service/AuthService.java): `reclaim-backend/src/main/java/com/example/reclaimbackend/service/AuthService.java`
- [Item service](https://github.com/adistar350/reclaim/blob/main/reclaim-backend/src/main/java/com/example/reclaimbackend/service/ItemService.java): `reclaim-backend/src/main/java/com/example/reclaimbackend/service/ItemService.java`
- [Claim service](https://github.com/adistar350/reclaim/blob/main/reclaim-backend/src/main/java/com/example/reclaimbackend/service/ClaimService.java): `reclaim-backend/src/main/java/com/example/reclaimbackend/service/ClaimService.java`
- [User service](https://github.com/adistar350/reclaim/blob/main/reclaim-backend/src/main/java/com/example/reclaimbackend/service/UserService.java): `reclaim-backend/src/main/java/com/example/reclaimbackend/service/UserService.java`
- [Image storage service](https://github.com/adistar350/reclaim/blob/main/reclaim-backend/src/main/java/com/example/reclaimbackend/service/FirebaseStorageService.java): `reclaim-backend/src/main/java/com/example/reclaimbackend/service/FirebaseStorageService.java`
- [Push delivery](https://github.com/adistar350/reclaim/blob/main/reclaim-backend/src/main/java/com/example/reclaimbackend/service/PushNotificationService.java): `reclaim-backend/src/main/java/com/example/reclaimbackend/service/PushNotificationService.java`
- [Usage analytics](https://github.com/adistar350/reclaim/blob/main/reclaim-backend/src/main/java/com/example/reclaimbackend/service/ItemService.java): `reclaim-backend/src/main/java/com/example/reclaimbackend/service/ItemService.java`

### Persistence and media

- [MongoDB Atlas](https://github.com/adistar350/reclaim/tree/main/reclaim-backend/src/main/java/com/example/reclaimbackend/repository): `reclaim-backend/src/main/java/com/example/reclaimbackend/repository`

### External services

- **Firebase Storage**
- **Email delivery**
- **Maps and location**

### Other components

- **Owner or finder**

## Connections

- Owner or finder → App entry: uses (evidence: `README.md`)
- App entry → Authentication: enters
- Owner or finder → Browse and search: searches (evidence: `README.md`)
- Owner or finder → Item reporting: submits report (evidence: `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 (evidence: `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 (evidence: `README.md`)
- Claim service → MongoDB Atlas: stores claims (evidence: `README.md`)
- Authentication service → MongoDB Atlas: stores accounts
- Image storage service → Firebase Storage: stores images (evidence: `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 (evidence: `README.md`)
- Browse and search → Maps and location: filters location (evidence: `README.md`)
- Item service → Usage analytics: supports metrics
