# jeymsdrei/campus-lost-found architecture

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

- Interactive diagram: https://gitdiagram.com/jeymsdrei/campus-lost-found
- Repository: https://github.com/jeymsdrei/campus-lost-found

## Overview

This is a Laravel lost-and-found application. Users register or sign in, report lost or found items, browse listings, and submit claims for found items; administrators review claims and manage listings, users, and departments. Item matching is a distinct capability represented by a dedicated service and match records, though the sampled sources do not establish who invokes matching. The graph follows documented routing and sampled controller/model relationships; links for unsampled route targets or service wiring are omitted rather than inferred.

Main entry points: [`routes/web.php`](https://github.com/jeymsdrei/campus-lost-found/blob/main/routes/web.php) (Web routes), [`app/Http/Controllers/AdminController.php`](https://github.com/jeymsdrei/campus-lost-found/blob/main/app/Http/Controllers/AdminController.php) (Admin operations), [`app/Models/FoundItem.php`](https://github.com/jeymsdrei/campus-lost-found/blob/main/app/Models/FoundItem.php) (Found item records), [`routes/auth.php`](https://github.com/jeymsdrei/campus-lost-found/blob/main/routes/auth.php) (Auth routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Web and auth"]
  node_routes["Web routes<br/>[web.php]"]
  node_authroutes["Auth routes<br/>[auth.php]"]
  node_registration["Registration"]
  node_session["Session login"]
  node_loginrequest["Login validation<br/>[LoginRequest.php]"]
  node_user[("User account<br/>[User.php]")]
  node_home["Home dashboard<br/>[HomeController.php]"]
end

subgraph group_items["Item reporting"]
  node_lost["Lost item reports"]
  node_lostmodel[("Lost item records<br/>[LostItem.php]")]
  node_found["Found item reports"]
  node_foundmodel[("Found item records<br/>[FoundItem.php]")]
end

subgraph group_claims["Claims and matching"]
  node_claims["Claim submissions"]
  node_claimmodel[("Claim records<br/>[ClaimRequest.php]")]
  node_matching["Item matching"]
  node_matches[("Match records<br/>[ItemMatch.php]")]
end

subgraph group_admin["Administration"]
  node_admin["Admin operations"]
  node_departments["Department management"]
  node_departmentmodel[("Departments<br/>[Department.php]")]
  node_admincheck["Admin middleware"]
end

node_visitor(("Visitor"))

node_visitor -->|"sends requests"| node_routes
node_visitor -->|"sends auth requests"| node_authroutes
node_routes -->|"routes to"| node_home
node_routes -->|"routes to"| node_lost
node_routes -->|"routes to"| node_found
node_routes -->|"routes to"| node_claims
node_routes -->|"routes to"| node_admin
node_routes -->|"routes to"| node_departments
node_authroutes -->|"routes to"| node_registration
node_authroutes -->|"routes to"| node_session
node_registration -->|"creates account"| node_user
node_session -->|"authenticates through"| node_loginrequest
node_home -->|"reads"| node_lostmodel
node_home -->|"reads"| node_foundmodel
node_lost -->|"reads and writes"| node_lostmodel
node_found -->|"reads and writes"| node_foundmodel
node_claims -->|"reads and writes"| node_claimmodel
node_claims -->|"reads"| node_foundmodel
node_admin -->|"reviews"| node_claimmodel
node_admin -->|"manages"| node_foundmodel
node_admin -->|"manages"| node_lostmodel
node_admin -->|"manages"| node_user
node_departments -->|"reads and writes"| node_departmentmodel
node_departments -->|"reads"| node_user
node_admin -.->|"requires"| node_admincheck

click node_routes "https://github.com/jeymsdrei/campus-lost-found/blob/main/routes/web.php"
click node_authroutes "https://github.com/jeymsdrei/campus-lost-found/blob/main/routes/auth.php"
click node_registration "https://github.com/jeymsdrei/campus-lost-found/blob/main/app/Http/Controllers/Auth/RegisteredUserController.php"
click node_session "https://github.com/jeymsdrei/campus-lost-found/blob/main/app/Http/Controllers/Auth/AuthenticatedSessionController.php"
click node_loginrequest "https://github.com/jeymsdrei/campus-lost-found/blob/main/app/Http/Requests/Auth/LoginRequest.php"
click node_user "https://github.com/jeymsdrei/campus-lost-found/blob/main/app/Models/User.php"
click node_home "https://github.com/jeymsdrei/campus-lost-found/blob/main/app/Http/Controllers/HomeController.php"
click node_lost "https://github.com/jeymsdrei/campus-lost-found/blob/main/app/Http/Controllers/LostItemController.php"
click node_lostmodel "https://github.com/jeymsdrei/campus-lost-found/blob/main/app/Models/LostItem.php"
click node_found "https://github.com/jeymsdrei/campus-lost-found/blob/main/app/Http/Controllers/FoundItemController.php"
click node_foundmodel "https://github.com/jeymsdrei/campus-lost-found/blob/main/app/Models/FoundItem.php"
click node_claims "https://github.com/jeymsdrei/campus-lost-found/blob/main/app/Http/Controllers/ClaimController.php"
click node_claimmodel "https://github.com/jeymsdrei/campus-lost-found/blob/main/app/Models/ClaimRequest.php"
click node_matching "https://github.com/jeymsdrei/campus-lost-found/blob/main/app/Services/MatchingService.php"
click node_matches "https://github.com/jeymsdrei/campus-lost-found/blob/main/app/Models/ItemMatch.php"
click node_admin "https://github.com/jeymsdrei/campus-lost-found/blob/main/app/Http/Controllers/AdminController.php"
click node_departments "https://github.com/jeymsdrei/campus-lost-found/blob/main/app/Http/Controllers/DepartmentController.php"
click node_departmentmodel "https://github.com/jeymsdrei/campus-lost-found/blob/main/app/Models/Department.php"
click node_admincheck "https://github.com/jeymsdrei/campus-lost-found/blob/main/app/Http/Middleware/AdminMiddleware.php"

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_routes,node_authroutes,node_registration,node_session,node_loginrequest,node_user,node_home toneBlue
class node_lost,node_lostmodel,node_found,node_foundmodel toneAmber
class node_claims,node_claimmodel,node_matching,node_matches toneMint
class node_admin,node_departments,node_departmentmodel,node_admincheck toneRose
class node_visitor toneIndigo
```

## Components

### Web and auth

- [Web routes](https://github.com/jeymsdrei/campus-lost-found/blob/main/routes/web.php): `routes/web.php`
- [Auth routes](https://github.com/jeymsdrei/campus-lost-found/blob/main/routes/auth.php): `routes/auth.php`
- [Registration](https://github.com/jeymsdrei/campus-lost-found/blob/main/app/Http/Controllers/Auth/RegisteredUserController.php): `app/Http/Controllers/Auth/RegisteredUserController.php`
- [Session login](https://github.com/jeymsdrei/campus-lost-found/blob/main/app/Http/Controllers/Auth/AuthenticatedSessionController.php): `app/Http/Controllers/Auth/AuthenticatedSessionController.php`
- [Login validation](https://github.com/jeymsdrei/campus-lost-found/blob/main/app/Http/Requests/Auth/LoginRequest.php): `app/Http/Requests/Auth/LoginRequest.php`
- [User account](https://github.com/jeymsdrei/campus-lost-found/blob/main/app/Models/User.php): `app/Models/User.php`
- [Home dashboard](https://github.com/jeymsdrei/campus-lost-found/blob/main/app/Http/Controllers/HomeController.php): `app/Http/Controllers/HomeController.php`

### Item reporting

- [Lost item reports](https://github.com/jeymsdrei/campus-lost-found/blob/main/app/Http/Controllers/LostItemController.php): `app/Http/Controllers/LostItemController.php`
- [Lost item records](https://github.com/jeymsdrei/campus-lost-found/blob/main/app/Models/LostItem.php): `app/Models/LostItem.php`
- [Found item reports](https://github.com/jeymsdrei/campus-lost-found/blob/main/app/Http/Controllers/FoundItemController.php): `app/Http/Controllers/FoundItemController.php`
- [Found item records](https://github.com/jeymsdrei/campus-lost-found/blob/main/app/Models/FoundItem.php): `app/Models/FoundItem.php`

### Claims and matching

- [Claim submissions](https://github.com/jeymsdrei/campus-lost-found/blob/main/app/Http/Controllers/ClaimController.php): `app/Http/Controllers/ClaimController.php`
- [Claim records](https://github.com/jeymsdrei/campus-lost-found/blob/main/app/Models/ClaimRequest.php): `app/Models/ClaimRequest.php`
- [Item matching](https://github.com/jeymsdrei/campus-lost-found/blob/main/app/Services/MatchingService.php): `app/Services/MatchingService.php`
- [Match records](https://github.com/jeymsdrei/campus-lost-found/blob/main/app/Models/ItemMatch.php): `app/Models/ItemMatch.php`

### Administration

- [Admin operations](https://github.com/jeymsdrei/campus-lost-found/blob/main/app/Http/Controllers/AdminController.php): `app/Http/Controllers/AdminController.php`
- [Department management](https://github.com/jeymsdrei/campus-lost-found/blob/main/app/Http/Controllers/DepartmentController.php): `app/Http/Controllers/DepartmentController.php`
- [Departments](https://github.com/jeymsdrei/campus-lost-found/blob/main/app/Models/Department.php): `app/Models/Department.php`
- [Admin middleware](https://github.com/jeymsdrei/campus-lost-found/blob/main/app/Http/Middleware/AdminMiddleware.php): `app/Http/Middleware/AdminMiddleware.php`

### Other components

- **Visitor**

## Connections

- Visitor → Web routes: sends requests (evidence: `routes/web.php`)
- Visitor → Auth routes: sends auth requests (evidence: `routes/auth.php`)
- Web routes → Home dashboard: routes to (evidence: `routes/web.php`)
- Web routes → Lost item reports: routes to (evidence: `routes/web.php`)
- Web routes → Found item reports: routes to (evidence: `routes/web.php`)
- Web routes → Claim submissions: routes to (evidence: `routes/web.php`)
- Web routes → Admin operations: routes to (evidence: `routes/web.php`)
- Web routes → Department management: routes to (evidence: `routes/web.php`)
- Auth routes → Registration: routes to (evidence: `routes/auth.php`)
- Auth routes → Session login: routes to (evidence: `routes/auth.php`)
- Registration → User account: creates account (evidence: `app/Http/Controllers/Auth/RegisteredUserController.php`)
- Session login → Login validation: authenticates through (evidence: `app/Http/Controllers/Auth/AuthenticatedSessionController.php`)
- Home dashboard → Lost item records: reads (evidence: `app/Http/Controllers/HomeController.php`)
- Home dashboard → Found item records: reads (evidence: `app/Http/Controllers/HomeController.php`)
- Lost item reports → Lost item records: reads and writes (evidence: `app/Http/Controllers/LostItemController.php`)
- Found item reports → Found item records: reads and writes (evidence: `app/Http/Controllers/FoundItemController.php`)
- Claim submissions → Claim records: reads and writes (evidence: `app/Http/Controllers/ClaimController.php`)
- Claim submissions → Found item records: reads (evidence: `app/Http/Controllers/ClaimController.php`)
- Admin operations → Claim records: reviews (evidence: `app/Http/Controllers/AdminController.php`)
- Admin operations → Found item records: manages (evidence: `app/Http/Controllers/AdminController.php`)
- Admin operations → Lost item records: manages (evidence: `app/Http/Controllers/AdminController.php`)
- Admin operations → User account: manages (evidence: `app/Http/Controllers/AdminController.php`)
- Department management → Departments: reads and writes (evidence: `app/Http/Controllers/DepartmentController.php`)
- Department management → User account: reads (evidence: `app/Http/Controllers/DepartmentController.php`)
- Admin operations → Admin middleware: requires
