# shanmukha-veera-sai/campus-l-f architecture

> Architecture diagram of the GitHub repository shanmukha-veera-sai/campus-l-f, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/shanmukha-veera-sai/campus-l-f
- Repository: https://github.com/shanmukha-veera-sai/campus-l-f

## Overview

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: [`src/main/resources/static/js/app.js`](https://github.com/shanmukha-veera-sai/campus-l-f/blob/main/src/main/resources/static/js/app.js) (Portal UI), [`src/main/java/com/campus/lostfound/service/ClaimRequestService.java`](https://github.com/shanmukha-veera-sai/campus-l-f/blob/main/src/main/java/com/campus/lostfound/service/ClaimRequestService.java) (Claim review), [`src/main/java/com/campus/lostfound/service/ConversationService.java`](https://github.com/shanmukha-veera-sai/campus-l-f/blob/main/src/main/java/com/campus/lostfound/service/ConversationService.java) (Claim-restricted chat), [`src/main/java/com/campus/lostfound/service/StudentService.java`](https://github.com/shanmukha-veera-sai/campus-l-f/blob/main/src/main/java/com/campus/lostfound/service/StudentService.java) (Student profiles)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Student experience"]
  node_web["Portal UI<br/>[app.js]"]
end

subgraph group_identity["Identity and profiles"]
  node_auth_api["Authentication API"]
  node_profile_api["Profile API"]
  node_student_service["Student profiles"]
  node_student_entity["Student records<br/>[Student.java]"]
end

subgraph group_listings["Listings and claims"]
  node_item_api["Item reports API"]
  node_item_service["Listing search and CRUD"]
  node_item_entity["Item reports<br/>[ItemReport.java]"]
  node_claim_api["Claims API"]
  node_claim_service["Claim review"]
  node_claim_entity["Claim records<br/>[ClaimRequest.java]"]
end

subgraph group_handover["Handover and updates"]
  node_chat_api["Chat API"]
  node_conversation_service["Claim-restricted chat"]
  node_conversation_entity["Conversations<br/>[Conversation.java]"]
  node_message_entity["Chat messages<br/>[Message.java]"]
  node_notification_api["Notifications API"]
  node_notification_service["Notification delivery"]
  node_notification_entity["Notification records<br/>[Notification.java]"]
end

subgraph group_persistence["Persistence and support"]
  node_file_service["Photo storage"]
  node_api_response["API response wrapper<br/>[ApiResponse.java]"]
  node_exception_handler["Error responses"]
  node_mysql[("MySQL database")]
end

node_student(("Student"))

node_student -->|"uses"| node_web
node_web -.->|"authenticates"| node_auth_api
node_web -.->|"manages profile"| node_profile_api
node_web -.->|"searches listings"| node_item_api
node_web -.->|"submits claims"| node_claim_api
node_web -.->|"coordinates handover"| node_chat_api
node_web -.->|"checks updates"| node_notification_api
node_auth_api -->|"delegates to"| node_student_service
node_profile_api -.->|"delegates to"| node_student_service
node_student_service -->|"manages"| node_student_entity
node_student_service -->|"stores photos"| node_file_service
node_item_api -->|"delegates to"| node_item_service
node_item_service -->|"manages"| node_item_entity
node_item_service -->|"stores photos"| node_file_service
node_claim_api -->|"delegates to"| node_claim_service
node_claim_service -->|"creates and reviews"| node_claim_entity
node_claim_service -->|"notifies participants"| node_notification_service
node_claim_service -->|"opens conversation"| node_conversation_entity
node_chat_api -->|"delegates to"| node_conversation_service
node_conversation_service -->|"checks and manages"| node_conversation_entity
node_conversation_service -->|"stores messages"| node_message_entity
node_conversation_service -->|"notifies recipient"| node_notification_service
node_notification_api -.->|"delegates to"| node_notification_service
node_notification_service -->|"creates and maps"| node_notification_entity
node_student_service -.->|"persists profiles"| node_mysql
node_item_service -.->|"persists listings"| node_mysql
node_claim_service -.->|"persists claims"| node_mysql
node_conversation_service -.->|"persists chat"| node_mysql
node_notification_service -->|"persists notifications"| node_mysql
node_file_service -.->|"stores photo paths"| node_student_entity
node_file_service -.->|"stores photo paths"| node_item_entity
node_api_response -->|"formats errors"| node_exception_handler

click node_web "https://github.com/shanmukha-veera-sai/campus-l-f/blob/main/src/main/resources/static/js/app.js"
click node_auth_api "https://github.com/shanmukha-veera-sai/campus-l-f/blob/main/src/main/java/com/campus/lostfound/controller/AuthController.java"
click node_profile_api "https://github.com/shanmukha-veera-sai/campus-l-f/blob/main/src/main/java/com/campus/lostfound/controller/ProfileController.java"
click node_student_service "https://github.com/shanmukha-veera-sai/campus-l-f/blob/main/src/main/java/com/campus/lostfound/service/StudentService.java"
click node_student_entity "https://github.com/shanmukha-veera-sai/campus-l-f/blob/main/src/main/java/com/campus/lostfound/entity/Student.java"
click node_item_api "https://github.com/shanmukha-veera-sai/campus-l-f/blob/main/src/main/java/com/campus/lostfound/controller/ItemReportController.java"
click node_item_service "https://github.com/shanmukha-veera-sai/campus-l-f/blob/main/src/main/java/com/campus/lostfound/service/ItemReportService.java"
click node_item_entity "https://github.com/shanmukha-veera-sai/campus-l-f/blob/main/src/main/java/com/campus/lostfound/entity/ItemReport.java"
click node_claim_api "https://github.com/shanmukha-veera-sai/campus-l-f/blob/main/src/main/java/com/campus/lostfound/controller/ClaimRequestController.java"
click node_claim_service "https://github.com/shanmukha-veera-sai/campus-l-f/blob/main/src/main/java/com/campus/lostfound/service/ClaimRequestService.java"
click node_claim_entity "https://github.com/shanmukha-veera-sai/campus-l-f/blob/main/src/main/java/com/campus/lostfound/entity/ClaimRequest.java"
click node_chat_api "https://github.com/shanmukha-veera-sai/campus-l-f/blob/main/src/main/java/com/campus/lostfound/controller/ChatController.java"
click node_conversation_service "https://github.com/shanmukha-veera-sai/campus-l-f/blob/main/src/main/java/com/campus/lostfound/service/ConversationService.java"
click node_conversation_entity "https://github.com/shanmukha-veera-sai/campus-l-f/blob/main/src/main/java/com/campus/lostfound/entity/Conversation.java"
click node_message_entity "https://github.com/shanmukha-veera-sai/campus-l-f/blob/main/src/main/java/com/campus/lostfound/entity/Message.java"
click node_notification_api "https://github.com/shanmukha-veera-sai/campus-l-f/blob/main/src/main/java/com/campus/lostfound/controller/NotificationController.java"
click node_notification_service "https://github.com/shanmukha-veera-sai/campus-l-f/blob/main/src/main/java/com/campus/lostfound/service/NotificationService.java"
click node_notification_entity "https://github.com/shanmukha-veera-sai/campus-l-f/blob/main/src/main/java/com/campus/lostfound/entity/Notification.java"
click node_file_service "https://github.com/shanmukha-veera-sai/campus-l-f/blob/main/src/main/java/com/campus/lostfound/service/FileStorageService.java"
click node_api_response "https://github.com/shanmukha-veera-sai/campus-l-f/blob/main/src/main/java/com/campus/lostfound/dto/ApiResponse.java"
click node_exception_handler "https://github.com/shanmukha-veera-sai/campus-l-f/blob/main/src/main/java/com/campus/lostfound/exception/GlobalExceptionHandler.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_web toneBlue
class node_auth_api,node_profile_api,node_student_service,node_student_entity toneAmber
class node_item_api,node_item_service,node_item_entity,node_claim_api,node_claim_service,node_claim_entity toneMint
class node_chat_api,node_conversation_service,node_conversation_entity,node_message_entity,node_notification_api,node_notification_service,node_notification_entity toneRose
class node_file_service,node_api_response,node_exception_handler,node_mysql,node_student toneIndigo
```

## Components

### Student experience

- [Portal UI](https://github.com/shanmukha-veera-sai/campus-l-f/blob/main/src/main/resources/static/js/app.js): `src/main/resources/static/js/app.js`

### Identity and profiles

- [Authentication API](https://github.com/shanmukha-veera-sai/campus-l-f/blob/main/src/main/java/com/campus/lostfound/controller/AuthController.java): `src/main/java/com/campus/lostfound/controller/AuthController.java`
- [Profile API](https://github.com/shanmukha-veera-sai/campus-l-f/blob/main/src/main/java/com/campus/lostfound/controller/ProfileController.java): `src/main/java/com/campus/lostfound/controller/ProfileController.java`
- [Student profiles](https://github.com/shanmukha-veera-sai/campus-l-f/blob/main/src/main/java/com/campus/lostfound/service/StudentService.java): `src/main/java/com/campus/lostfound/service/StudentService.java`
- [Student records](https://github.com/shanmukha-veera-sai/campus-l-f/blob/main/src/main/java/com/campus/lostfound/entity/Student.java): `src/main/java/com/campus/lostfound/entity/Student.java`

### Listings and claims

- [Item reports API](https://github.com/shanmukha-veera-sai/campus-l-f/blob/main/src/main/java/com/campus/lostfound/controller/ItemReportController.java): `src/main/java/com/campus/lostfound/controller/ItemReportController.java`
- [Listing search and CRUD](https://github.com/shanmukha-veera-sai/campus-l-f/blob/main/src/main/java/com/campus/lostfound/service/ItemReportService.java): `src/main/java/com/campus/lostfound/service/ItemReportService.java`
- [Item reports](https://github.com/shanmukha-veera-sai/campus-l-f/blob/main/src/main/java/com/campus/lostfound/entity/ItemReport.java): `src/main/java/com/campus/lostfound/entity/ItemReport.java`
- [Claims API](https://github.com/shanmukha-veera-sai/campus-l-f/blob/main/src/main/java/com/campus/lostfound/controller/ClaimRequestController.java): `src/main/java/com/campus/lostfound/controller/ClaimRequestController.java`
- [Claim review](https://github.com/shanmukha-veera-sai/campus-l-f/blob/main/src/main/java/com/campus/lostfound/service/ClaimRequestService.java): `src/main/java/com/campus/lostfound/service/ClaimRequestService.java`
- [Claim records](https://github.com/shanmukha-veera-sai/campus-l-f/blob/main/src/main/java/com/campus/lostfound/entity/ClaimRequest.java): `src/main/java/com/campus/lostfound/entity/ClaimRequest.java`

### Handover and updates

- [Chat API](https://github.com/shanmukha-veera-sai/campus-l-f/blob/main/src/main/java/com/campus/lostfound/controller/ChatController.java): `src/main/java/com/campus/lostfound/controller/ChatController.java`
- [Claim-restricted chat](https://github.com/shanmukha-veera-sai/campus-l-f/blob/main/src/main/java/com/campus/lostfound/service/ConversationService.java): `src/main/java/com/campus/lostfound/service/ConversationService.java`
- [Conversations](https://github.com/shanmukha-veera-sai/campus-l-f/blob/main/src/main/java/com/campus/lostfound/entity/Conversation.java): `src/main/java/com/campus/lostfound/entity/Conversation.java`
- [Chat messages](https://github.com/shanmukha-veera-sai/campus-l-f/blob/main/src/main/java/com/campus/lostfound/entity/Message.java): `src/main/java/com/campus/lostfound/entity/Message.java`
- [Notifications API](https://github.com/shanmukha-veera-sai/campus-l-f/blob/main/src/main/java/com/campus/lostfound/controller/NotificationController.java): `src/main/java/com/campus/lostfound/controller/NotificationController.java`
- [Notification delivery](https://github.com/shanmukha-veera-sai/campus-l-f/blob/main/src/main/java/com/campus/lostfound/service/NotificationService.java): `src/main/java/com/campus/lostfound/service/NotificationService.java`
- [Notification records](https://github.com/shanmukha-veera-sai/campus-l-f/blob/main/src/main/java/com/campus/lostfound/entity/Notification.java): `src/main/java/com/campus/lostfound/entity/Notification.java`

### Persistence and support

- [Photo storage](https://github.com/shanmukha-veera-sai/campus-l-f/blob/main/src/main/java/com/campus/lostfound/service/FileStorageService.java): `src/main/java/com/campus/lostfound/service/FileStorageService.java`
- [API response wrapper](https://github.com/shanmukha-veera-sai/campus-l-f/blob/main/src/main/java/com/campus/lostfound/dto/ApiResponse.java): `src/main/java/com/campus/lostfound/dto/ApiResponse.java`
- [Error responses](https://github.com/shanmukha-veera-sai/campus-l-f/blob/main/src/main/java/com/campus/lostfound/exception/GlobalExceptionHandler.java): `src/main/java/com/campus/lostfound/exception/GlobalExceptionHandler.java`
- **MySQL database**

### Other components

- **Student**

## Connections

- 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 (evidence: `src/main/java/com/campus/lostfound/controller/AuthController.java`)
- Profile API → Student profiles: delegates to (evidence: `src/main/java/com/campus/lostfound/controller/ProfileController.java`)
- Student profiles → Student records: manages (evidence: `src/main/java/com/campus/lostfound/service/StudentService.java`)
- Student profiles → Photo storage: stores photos (evidence: `src/main/java/com/campus/lostfound/service/StudentService.java`)
- Item reports API → Listing search and CRUD: delegates to (evidence: `src/main/java/com/campus/lostfound/controller/ItemReportController.java`)
- Listing search and CRUD → Item reports: manages (evidence: `src/main/java/com/campus/lostfound/service/ItemReportService.java`)
- Listing search and CRUD → Photo storage: stores photos (evidence: `src/main/java/com/campus/lostfound/service/ItemReportService.java`)
- Claims API → Claim review: delegates to (evidence: `src/main/java/com/campus/lostfound/controller/ClaimRequestController.java`)
- Claim review → Claim records: creates and reviews (evidence: `src/main/java/com/campus/lostfound/service/ClaimRequestService.java`)
- Claim review → Notification delivery: notifies participants (evidence: `src/main/java/com/campus/lostfound/service/ClaimRequestService.java`)
- Claim review → Conversations: opens conversation (evidence: `src/main/java/com/campus/lostfound/service/ClaimRequestService.java`)
- Chat API → Claim-restricted chat: delegates to (evidence: `src/main/java/com/campus/lostfound/controller/ChatController.java`)
- Claim-restricted chat → Conversations: checks and manages (evidence: `src/main/java/com/campus/lostfound/service/ConversationService.java`)
- Claim-restricted chat → Chat messages: stores messages (evidence: `src/main/java/com/campus/lostfound/service/ConversationService.java`)
- Claim-restricted chat → Notification delivery: notifies recipient (evidence: `src/main/java/com/campus/lostfound/service/ConversationService.java`)
- Notifications API → Notification delivery: delegates to (evidence: `src/main/java/com/campus/lostfound/controller/NotificationController.java`)
- Notification delivery → Notification records: creates and maps (evidence: `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 (evidence: `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 (evidence: `src/main/java/com/campus/lostfound/exception/GlobalExceptionHandler.java`)
