# sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system architecture

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

- Interactive diagram: https://gitdiagram.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system
- Repository: https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system

## Overview

UniTrace is a console-based campus lost-and-found application. Students search found items, file lost-item reports, and submit item-specific proof to claim an item; an administrator logs found items, reviews claims, verifies pickup identity, and releases items with a receipt. The in-memory registry owns item search, report matching, claim state transitions, and release. The README documents these capabilities; sampled source confirms the main UI-to-registry flow and claim lifecycle. Unshown implementations are represented only where the README or source index supports them.

Main entry points: [`ItemRegistry.java`](https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/ItemRegistry.java) (In-memory registry), [`ConsoleUI.java`](https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/ConsoleUI.java) (Role menus), [`Item.java`](https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/Item.java) (Found item model), [`ClaimRequest[1].java`](https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/ClaimRequest%5B1%5D.java) (Claim request)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Console experience"]
  node_console["Role menus<br/>[ConsoleUI.java]"]
  node_input["Console input<br/>[InputHelper.java]"]
  node_guard["Admin guard<br/>[AdminGuard.java]"]
end

subgraph group_records["Item and report domain"]
  node_student["Student<br/>[Student.java]"]
  node_user["User<br/>[User.java]"]
  node_item["Found item model<br/>[Item.java]"]
  node_item_kinds["Item categories<br/>[ItemCategory.java]"]
  node_item_status["Item statuses<br/>[ItemStatus.java]"]
  node_id_card["Student ID item<br/>[StudentIDCard.java]"]
  node_electronics["Electronics item<br/>[Electronics.java]"]
  node_belonging["Personal belonging"]
  node_lost_report["Lost-item report<br/>[LostReport.java]"]
  node_match_result["Match result"]
  node_not_found_error["Item lookup errors"]
end

subgraph group_claims["Claim lifecycle"]
  node_claim_processor["Claim processing"]
  node_claim_request["Claim request"]
  node_claim_status["Claim statuses"]
  node_claimable["Proof contract<br/>[Claimable.java]"]
  node_claim_error["Claim errors"]
  node_transition_error["Transition errors"]
end

subgraph group_runtime["Application runtime"]
  node_registry[("In-memory registry<br/>[ItemRegistry.java]")]
  node_text_util["Text utilities<br/>[TextUtil.java]"]
  node_main["Program entry<br/>[Main.java]"]
end

node_operator(("Student or admin"))

node_main -->|"creates and seeds"| node_registry
node_main -->|"starts"| node_console
node_operator -->|"uses menus"| node_console
node_console -->|"reads input"| node_input
node_console -->|"authenticates admin"| node_guard
node_console -->|"requests operations"| node_registry
node_console -->|"creates reports"| node_lost_report
node_console -->|"constructs item"| node_id_card
node_console -->|"constructs item"| node_electronics
node_console -->|"constructs item"| node_belonging
node_console -->|"displays claims"| node_claim_request
node_registry -->|"stores and searches"| node_item
node_registry -->|"stores and matches"| node_lost_report
node_registry -->|"returns matches"| node_match_result
node_registry -->|"creates and updates"| node_claim_request
node_registry -->|"implements"| node_claim_processor
node_registry -->|"throws"| node_claim_error
node_registry -->|"throws"| node_transition_error
node_registry -->|"throws"| node_not_found_error
node_registry -->|"normalizes and formats"| node_text_util
node_item -->|"implements"| node_claimable
node_id_card -->|"extends"| node_item
node_electronics -->|"extends"| node_item
node_belonging -->|"extends"| node_item
node_item -->|"uses category"| node_item_kinds
node_item -->|"tracks lifecycle"| node_item_status
node_student -->|"extends"| node_user
node_claim_request -->|"records claimant"| node_student
node_claim_request -->|"records claimed item"| node_item

click node_student "https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/Student.java"
click node_user "https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/User.java"
click node_item "https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/Item.java"
click node_item_kinds "https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/ItemCategory.java"
click node_item_status "https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/ItemStatus.java"
click node_id_card "https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/StudentIDCard.java"
click node_electronics "https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/Electronics.java"
click node_belonging "https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/PersonalBelonging.java"
click node_lost_report "https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/LostReport.java"
click node_match_result "https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/MatchResult%5B1%5D.java"
click node_registry "https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/ItemRegistry.java"
click node_claim_processor "https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/ClaimProcessor.java"
click node_claim_request "https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/ClaimRequest%5B1%5D.java"
click node_claim_status "https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/ClaimStatus%5B1%5D.java"
click node_claimable "https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/Claimable.java"
click node_console "https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/ConsoleUI.java"
click node_input "https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/InputHelper.java"
click node_guard "https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/AdminGuard.java"
click node_text_util "https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/TextUtil.java"
click node_claim_error "https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/InvalidClaimException.java"
click node_transition_error "https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/InvalidStatusTransitionException.java"
click node_not_found_error "https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/ItemNotFoundException.java"
click node_main "https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/Main.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_console,node_input,node_guard toneBlue
class node_student,node_user,node_item,node_item_kinds,node_item_status,node_id_card,node_electronics,node_belonging,node_lost_report,node_match_result,node_not_found_error toneAmber
class node_claim_processor,node_claim_request,node_claim_status,node_claimable,node_claim_error,node_transition_error toneMint
class node_registry,node_text_util,node_main toneRose
class node_operator toneIndigo
```

## Components

### Console experience

- [Role menus](https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/ConsoleUI.java): `ConsoleUI.java`
- [Console input](https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/InputHelper.java): `InputHelper.java`
- [Admin guard](https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/AdminGuard.java): `AdminGuard.java`

### Item and report domain

- [Student](https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/Student.java): `Student.java`
- [User](https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/User.java): `User.java`
- [Found item model](https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/Item.java): `Item.java`
- [Item categories](https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/ItemCategory.java): `ItemCategory.java`
- [Item statuses](https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/ItemStatus.java): `ItemStatus.java`
- [Student ID item](https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/StudentIDCard.java): `StudentIDCard.java`
- [Electronics item](https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/Electronics.java): `Electronics.java`
- [Personal belonging](https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/PersonalBelonging.java): `PersonalBelonging.java`
- [Lost-item report](https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/LostReport.java): `LostReport.java`
- [Match result](https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/MatchResult%5B1%5D.java): `MatchResult[1].java`
- [Item lookup errors](https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/ItemNotFoundException.java): `ItemNotFoundException.java`

### Claim lifecycle

- [Claim processing](https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/ClaimProcessor.java): `ClaimProcessor.java`
- [Claim request](https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/ClaimRequest%5B1%5D.java): `ClaimRequest[1].java`
- [Claim statuses](https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/ClaimStatus%5B1%5D.java): `ClaimStatus[1].java`
- [Proof contract](https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/Claimable.java): `Claimable.java`
- [Claim errors](https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/InvalidClaimException.java): `InvalidClaimException.java`
- [Transition errors](https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/InvalidStatusTransitionException.java): `InvalidStatusTransitionException.java`

### Application runtime

- [In-memory registry](https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/ItemRegistry.java): `ItemRegistry.java`
- [Text utilities](https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/TextUtil.java): `TextUtil.java`
- [Program entry](https://github.com/sev1r0us/unitrace-an-object-oriented-campus-lost-and-found-management-system/blob/main/Main.java): `Main.java`

### Other components

- **Student or admin**

## Connections

- Program entry → In-memory registry: creates and seeds (evidence: `Main.java`)
- Program entry → Role menus: starts (evidence: `Main.java`)
- Student or admin → Role menus: uses menus (evidence: `README.md`)
- Role menus → Console input: reads input (evidence: `ConsoleUI.java`)
- Role menus → Admin guard: authenticates admin (evidence: `ConsoleUI.java`)
- Role menus → In-memory registry: requests operations (evidence: `ConsoleUI.java`)
- Role menus → Lost-item report: creates reports (evidence: `ConsoleUI.java`)
- Role menus → Student ID item: constructs item (evidence: `ConsoleUI.java`)
- Role menus → Electronics item: constructs item (evidence: `ConsoleUI.java`)
- Role menus → Personal belonging: constructs item (evidence: `ConsoleUI.java`)
- Role menus → Claim request: displays claims (evidence: `ConsoleUI.java`)
- In-memory registry → Found item model: stores and searches (evidence: `ItemRegistry.java`)
- In-memory registry → Lost-item report: stores and matches (evidence: `ItemRegistry.java`)
- In-memory registry → Match result: returns matches (evidence: `ItemRegistry.java`)
- In-memory registry → Claim request: creates and updates (evidence: `ItemRegistry.java`)
- In-memory registry → Claim processing: implements (evidence: `ItemRegistry.java`)
- In-memory registry → Claim errors: throws (evidence: `ItemRegistry.java`)
- In-memory registry → Transition errors: throws (evidence: `ItemRegistry.java`)
- In-memory registry → Item lookup errors: throws (evidence: `ItemRegistry.java`)
- In-memory registry → Text utilities: normalizes and formats (evidence: `ItemRegistry.java`)
- Found item model → Proof contract: implements (evidence: `Item.java`)
- Student ID item → Found item model: extends (evidence: `StudentIDCard.java`)
- Electronics item → Found item model: extends (evidence: `Electronics.java`)
- Personal belonging → Found item model: extends (evidence: `PersonalBelonging.java`)
- Found item model → Item categories: uses category (evidence: `Item.java`)
- Found item model → Item statuses: tracks lifecycle (evidence: `Item.java`)
- Student → User: extends (evidence: `Student.java`)
- Claim request → Student: records claimant (evidence: `ClaimRequest[1].java`)
- Claim request → Found item model: records claimed item (evidence: `ClaimRequest[1].java`)
