# chaithanyar2103/lost-and-found architecture

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

- Interactive diagram: https://gitdiagram.com/chaithanyar2103/lost-and-found
- Repository: https://github.com/chaithanyar2103/lost-and-found

## Overview

Lost-found is a small Spring Boot web app for reporting and managing lost and found items. Users can use its single-page interface or the documented REST API to create and list items, filter by status, claim items, and delete them; the app stores data in memory. Separate endpoints expose service information and health. The README documents these capabilities, but no source excerpts were provided, so relationships below reflect documented behavior only; deployment and CI tooling are excluded.

Main entry points: [`src/main/java/com/example/lostfound/ItemController.java`](https://github.com/chaithanyar2103/lost-and-found/blob/main/src/main/java/com/example/lostfound/ItemController.java) (Items API), [`src/main/resources/static/index.html`](https://github.com/chaithanyar2103/lost-and-found/blob/main/src/main/resources/static/index.html) (Single-page UI), [`src/main/java/com/example/lostfound/Item.java`](https://github.com/chaithanyar2103/lost-and-found/blob/main/src/main/java/com/example/lostfound/Item.java) (Item model), [`src/main/java/com/example/lostfound/ItemRequest.java`](https://github.com/chaithanyar2103/lost-and-found/blob/main/src/main/java/com/example/lostfound/ItemRequest.java) (Item request)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["User interface"]
  node_web_ui["Single-page UI<br/>[index.html]"]
end

subgraph group_items["Item management"]
  node_items_api["Items API"]
  node_item_data[("In-memory items")]
  node_item_model["Item model<br/>[Item.java]"]
  node_item_request["Item request<br/>[ItemRequest.java]"]
end

subgraph group_operations["Service status"]
  node_service_info["Service info"]
  node_health_probe["Health endpoint"]
end

node_user(("User"))

node_user -->|"visits"| node_web_ui
node_user -->|"uses endpoints"| node_items_api
node_items_api -->|"manages items"| node_item_data
node_items_api -->|"returns items"| node_item_model
node_items_api -->|"accepts fields"| node_item_request
node_user -->|"requests info"| node_service_info
node_user -->|"checks health"| node_health_probe

click node_web_ui "https://github.com/chaithanyar2103/lost-and-found/blob/main/src/main/resources/static/index.html"
click node_items_api "https://github.com/chaithanyar2103/lost-and-found/blob/main/src/main/java/com/example/lostfound/ItemController.java"
click node_item_data "https://github.com/chaithanyar2103/lost-and-found/blob/main/src/main/java/com/example/lostfound/ItemController.java"
click node_item_model "https://github.com/chaithanyar2103/lost-and-found/blob/main/src/main/java/com/example/lostfound/Item.java"
click node_item_request "https://github.com/chaithanyar2103/lost-and-found/blob/main/src/main/java/com/example/lostfound/ItemRequest.java"
click node_service_info "https://github.com/chaithanyar2103/lost-and-found/blob/main/src/main/java/com/example/lostfound/InfoController.java"
click node_health_probe "https://github.com/chaithanyar2103/lost-and-found/blob/main/src/main/resources/application.properties"

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_ui,node_user toneBlue
class node_items_api,node_item_data,node_item_model,node_item_request toneAmber
class node_service_info,node_health_probe toneMint
```

## Components

### User interface

- [Single-page UI](https://github.com/chaithanyar2103/lost-and-found/blob/main/src/main/resources/static/index.html): `src/main/resources/static/index.html`

### Item management

- [Items API](https://github.com/chaithanyar2103/lost-and-found/blob/main/src/main/java/com/example/lostfound/ItemController.java): `src/main/java/com/example/lostfound/ItemController.java`
- [In-memory items](https://github.com/chaithanyar2103/lost-and-found/blob/main/src/main/java/com/example/lostfound/ItemController.java): `src/main/java/com/example/lostfound/ItemController.java`
- [Item model](https://github.com/chaithanyar2103/lost-and-found/blob/main/src/main/java/com/example/lostfound/Item.java): `src/main/java/com/example/lostfound/Item.java`
- [Item request](https://github.com/chaithanyar2103/lost-and-found/blob/main/src/main/java/com/example/lostfound/ItemRequest.java): `src/main/java/com/example/lostfound/ItemRequest.java`

### Service status

- [Service info](https://github.com/chaithanyar2103/lost-and-found/blob/main/src/main/java/com/example/lostfound/InfoController.java): `src/main/java/com/example/lostfound/InfoController.java`
- [Health endpoint](https://github.com/chaithanyar2103/lost-and-found/blob/main/src/main/resources/application.properties): `src/main/resources/application.properties`

### Other components

- **User**

## Connections

- User → Single-page UI: visits (evidence: `README.md`)
- User → Items API: uses endpoints (evidence: `README.md`)
- Items API → In-memory items: manages items (evidence: `README.md`)
- Items API → Item model: returns items (evidence: `README.md`)
- Items API → Item request: accepts fields (evidence: `README.md`)
- User → Service info: requests info (evidence: `README.md`)
- User → Health endpoint: checks health (evidence: `README.md`)