# poorvitha637/lost-and-found-management-system architecture

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

- Interactive diagram: https://gitdiagram.com/poorvitha637/lost-and-found-management-system
- Repository: https://github.com/poorvitha637/lost-and-found-management-system

## Overview

This PHP/MySQL Lost & Found application lets people report lost or found items, browse listings, search lost-item reports, and mark listings claimed. Its main flow is a user-submitted report, a save handler writing to MySQL, then a listing showing the item; claiming is a separate listing-to-update flow. The README also documents the MySQL schema and returned-items table. The configured `db.php` is not in the tree; setup instructs users to create it from the supplied example, so runtime connection details are not fully represented here.

Main entry points: [`index.php`](https://github.com/poorvitha637/lost-and-found-management-system/blob/main/index.php) (Home), [`database/lost_and_found.sql`](https://github.com/poorvitha637/lost-and-found-management-system/blob/main/database/lost_and_found.sql) (Lost & Found Data), [`view_lost.php`](https://github.com/poorvitha637/lost-and-found-management-system/blob/main/view_lost.php) (Lost Listings), [`view_found.php`](https://github.com/poorvitha637/lost-and-found-management-system/blob/main/view_found.php) (Found Listings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Navigation"]
  node_home["Home<br/>[index.php]"]
end

subgraph group_reports["Item Reports"]
  node_lost_form["Lost Report Form<br/>[add_lost.php]"]
  node_found_form["Found Report Form<br/>[add_found.php]"]
  node_save_lost["Save Lost Report<br/>[save_lost.php]"]
  node_save_found["Save Found Report<br/>[save_found.php]"]
end

subgraph group_discovery["Browse and Search"]
  node_lost_list["Lost Listings<br/>[view_lost.php]"]
  node_found_list["Found Listings<br/>[view_found.php]"]
  node_search["Lost Item Search<br/>[search.php]"]
  node_claim["Mark Claimed<br/>[mark_returned.php]"]
end

subgraph group_storage["Persistence"]
  node_db_config["MySQL Connection Config<br/>[db.example.php]"]
  node_mysql[("Lost &amp; Found Data<br/>[lost_and_found.sql]")]
end

node_visitor(("User"))

node_visitor -->|"opens"| node_home
node_home -->|"opens"| node_lost_form
node_home -->|"opens"| node_found_form
node_home -->|"opens"| node_lost_list
node_home -->|"opens"| node_found_list
node_home -->|"opens"| node_search
node_lost_form -->|"posts report"| node_save_lost
node_found_form -->|"posts report"| node_save_found
node_save_lost -->|"inserts lost item"| node_mysql
node_save_found -->|"inserts found item"| node_mysql
node_lost_list -->|"reads lost items"| node_mysql
node_found_list -->|"reads found items"| node_mysql
node_search -->|"searches lost items"| node_mysql
node_lost_list -->|"requests claim"| node_claim
node_found_list -->|"requests claim"| node_claim
node_claim -->|"updates item status"| node_mysql
node_visitor -->|"submits report"| node_lost_form
node_visitor -->|"submits report"| node_found_form
node_db_config -->|"connects to"| node_mysql

click node_home "https://github.com/poorvitha637/lost-and-found-management-system/blob/main/index.php"
click node_lost_form "https://github.com/poorvitha637/lost-and-found-management-system/blob/main/add_lost.php"
click node_found_form "https://github.com/poorvitha637/lost-and-found-management-system/blob/main/add_found.php"
click node_save_lost "https://github.com/poorvitha637/lost-and-found-management-system/blob/main/save_lost.php"
click node_save_found "https://github.com/poorvitha637/lost-and-found-management-system/blob/main/save_found.php"
click node_lost_list "https://github.com/poorvitha637/lost-and-found-management-system/blob/main/view_lost.php"
click node_found_list "https://github.com/poorvitha637/lost-and-found-management-system/blob/main/view_found.php"
click node_search "https://github.com/poorvitha637/lost-and-found-management-system/blob/main/search.php"
click node_claim "https://github.com/poorvitha637/lost-and-found-management-system/blob/main/mark_returned.php"
click node_db_config "https://github.com/poorvitha637/lost-and-found-management-system/blob/main/includes/db.example.php"
click node_mysql "https://github.com/poorvitha637/lost-and-found-management-system/blob/main/database/lost_and_found.sql"

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_home,node_visitor toneBlue
class node_lost_form,node_found_form,node_save_lost,node_save_found toneAmber
class node_lost_list,node_found_list,node_search,node_claim toneMint
class node_db_config,node_mysql toneRose
```

## Components

### Navigation

- [Home](https://github.com/poorvitha637/lost-and-found-management-system/blob/main/index.php): `index.php`

### Item Reports

- [Lost Report Form](https://github.com/poorvitha637/lost-and-found-management-system/blob/main/add_lost.php): `add_lost.php`
- [Found Report Form](https://github.com/poorvitha637/lost-and-found-management-system/blob/main/add_found.php): `add_found.php`
- [Save Lost Report](https://github.com/poorvitha637/lost-and-found-management-system/blob/main/save_lost.php): `save_lost.php`
- [Save Found Report](https://github.com/poorvitha637/lost-and-found-management-system/blob/main/save_found.php): `save_found.php`

### Browse and Search

- [Lost Listings](https://github.com/poorvitha637/lost-and-found-management-system/blob/main/view_lost.php): `view_lost.php`
- [Found Listings](https://github.com/poorvitha637/lost-and-found-management-system/blob/main/view_found.php): `view_found.php`
- [Lost Item Search](https://github.com/poorvitha637/lost-and-found-management-system/blob/main/search.php): `search.php`
- [Mark Claimed](https://github.com/poorvitha637/lost-and-found-management-system/blob/main/mark_returned.php): `mark_returned.php`

### Persistence

- [MySQL Connection Config](https://github.com/poorvitha637/lost-and-found-management-system/blob/main/includes/db.example.php): `includes/db.example.php`
- [Lost & Found Data](https://github.com/poorvitha637/lost-and-found-management-system/blob/main/database/lost_and_found.sql): `database/lost_and_found.sql`

### Other components

- **User**

## Connections

- User → Home: opens (evidence: `README.md`)
- Home → Lost Report Form: opens (evidence: `index.php`)
- Home → Found Report Form: opens (evidence: `index.php`)
- Home → Lost Listings: opens (evidence: `index.php`)
- Home → Found Listings: opens (evidence: `index.php`)
- Home → Lost Item Search: opens (evidence: `index.php`)
- Lost Report Form → Save Lost Report: posts report (evidence: `add_lost.php`)
- Found Report Form → Save Found Report: posts report (evidence: `add_found.php`)
- Save Lost Report → Lost & Found Data: inserts lost item (evidence: `save_lost.php`)
- Save Found Report → Lost & Found Data: inserts found item (evidence: `save_found.php`)
- Lost Listings → Lost & Found Data: reads lost items (evidence: `view_lost.php`)
- Found Listings → Lost & Found Data: reads found items (evidence: `view_found.php`)
- Lost Item Search → Lost & Found Data: searches lost items (evidence: `search.php`)
- Lost Listings → Mark Claimed: requests claim (evidence: `view_lost.php`)
- Found Listings → Mark Claimed: requests claim (evidence: `view_found.php`)
- Mark Claimed → Lost & Found Data: updates item status (evidence: `mark_returned.php`)
- User → Lost Report Form: submits report (evidence: `README.md`)
- User → Found Report Form: submits report (evidence: `README.md`)
- MySQL Connection Config → Lost & Found Data: connects to (evidence: `includes/db.example.php`)